Kelola Permintaan Perubahan Musik

Catatan: YouTube Content ID API ditujukan untuk digunakan oleh partner konten YouTube dan tidak dapat diakses oleh semua developer atau pengguna YouTube. Jika Anda tidak melihat YouTube Content ID API sebagai salah satu layanan yang tercantum di Konsol API Google, lihat Pusat Bantuan YouTube untuk mempelajari Program Partner YouTube lebih lanjut.

Catatan: Informasi dalam panduan ini berlaku secara khusus untuk aset komposisi.

Di YouTube Studio, Anda dapat meminta perubahan pada aset musik yang Anda miliki. Anda juga dapat menggunakan Content ID API untuk:

  • Membuat permintaan perubahan
  • Status daftar permintaan perubahan

Halaman ini menyediakan ringkasan metode MusicChangeRequest di Content ID API. Panduan ini juga memberikan contoh cara membuat dan mencantumkan permintaan perubahan.

Persyaratan

Anda harus mendapatkan kredensial otorisasi untuk menggunakan API ini. Anda akan menggunakan token otorisasi dalam permintaan.

Jika menggunakan cURL, pastikan Anda membuat variabel AUTH_TOKEN untuk digunakan dalam perintah tersebut:

export AUTH_TOKEN="[YOUR_AUTH_TOKEN]"

Membuat permintaan perubahan musik

Anda dapat menggunakan metode musicChangeRequests.create untuk mengubah rilis atau jalur. Permintaan Anda harus menyertakan resource permintaan perubahan yang menentukan jenis perubahan yang ingin Anda lakukan. Kemudian, Anda dapat mencantumkan permintaan perubahan untuk memeriksa statusnya.

Jenis permintaan perubahan

Jenis permintaan yang valid meliputi:

  • misreconciledArtist: Permintaan untuk mengubah artis untuk rilis atau lagu. Memerlukan resource DesiredArtist. Gunakan opsi ini jika tidak terkait dengan artis utama atau artis unggulan yang diinginkan.
  • undesiredDiscography: Permintaan untuk mengubah channel artis yang terkait dengan rilis. Gunakan opsi ini jika rilis artis lain keliru muncul di channel artis.
  • incorrectPlayability: Permintaan untuk mengubah pemutaran rilis atau trek. Gunakan opsi ini jika tidak dapat diputar atau ditampilkan dalam produk sesuai yang diharapkan.
  • incorrectMusicVideo: Permintaan untuk mengubah video musik lagu. Memerlukan resource DesiredMusicVideo. Gunakan opsi ini jika tidak terkait dengan video musik yang diinginkan.
  • incorrectMetadata: Meminta untuk mengubah ejaan, format, atau terjemahan rilis atau trek.

Contoh: Rilis tidak dikaitkan dengan artis utama atau artis unggulan yang diinginkan

Misalnya Anda mengirimkan rilis ke YouTube Music, tetapi rilis tersebut menyertakan artis yang salah. Untuk membuat permintaan terkait perubahan ini:

  1. Temukan rilis yang terpengaruh di YouTube Studio. Salin nomor ID (seperti UPC) dari halaman YouTube Studio.

  2. Buat permintaan yang berisi pernyataan JSON berikut:

    '{
  "release": "releases/0012345678901", 
  "misreconciledArtist": {
    "channelId": "UCP8W_Atlibtp488XGcRkPnQ", 
    "newArtist": "false", 
    "supplementalInfo": "Comment about the change"
  }
}'
    • release adalah nomor ID rilis, yang dapat Anda temukan di YouTube Studio.
    • misreconciledArtist mengambil resource desiredArtist yang terdiri dari hal berikut:
      • channelId: ID channel artis yang ingin Anda pindahkan rilisnya. Anda bisa mendapatkan ID channel dengan mengunjungi channel artis di YouTube dan menyalin ID dari URL. Jika artis tidak ada dan merupakan artis baru, kosongkan channelId, dan tandai newArtist: true.
      • newArtist: Jika artis saat ini tidak ada di YouTube Music, tandai kolom ini true. Atau, jika Anda memberikan ID channel, tandai kolom ini false.
      • supplementalInfo: Komentar opsional tentang permintaan.

  3. Gunakan metode musicChangeRequests.create untuk membuat permintaan. Sertakan JSON yang berisi permintaan. Misalnya, perintah berikut menunjukkan cara Anda membuat permintaan ini dengan cURL:

    curl -v -H "Authorization: Bearer $AUTH_TOKEN" --json '{"release": "releases/0012345678901", "misreconciledArtist": {"channelId": "UCP8W_Atlibtp488XGcRkPnQ", "newArtist": "false", "supplementalInfo": "Comment about the change"}}' https://www.googleapis.com/youtube/partner/v1/music/changeRequests

Daftar permintaan perubahan

Untuk mengambil daftar permintaan perubahan musik yang dilaporkan, Anda menggunakan metode musicChangeRequests.list. Metode ini merespons dengan daftar permintaan perubahan, yang difilter menurut pemilik konten. Anda juga dapat memfilter hasilnya menurut rilis atau jalur, dan berdasarkan pemilik konten.

Contoh: Mencantumkan permintaan perubahan untuk rilis tertentu

Misalnya Anda perlu mendapatkan permintaan perubahan untuk rilis tertentu dengan pemilik konten lain. Perintah berikut adalah contoh cara Anda membuat permintaan ini dengan cURL:

curl -v -H "Authorization: Bearer $AUTH_TOKEN" https://www.googleapis.com/youtube/partner/v1/music/changeRequests?onBehalfOfContentOwner=91U_FgOL8S7d52aNESfMaw&filter.parent=releases/0999999999999

dalam hal ini:

  • onBehalfOfContentOwner adalah ID Channel pemilik konten yang memiliki rilis atau trek.
  • filter menentukan release/[RELEASE_ID_NUMBER] atau track/[TRACK_ID_NUMBER].