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.
Setiap objek dalam sistem pengelolaan hak YouTube dikaitkan dengan pemilik konten. Pemilik konten adalah partner YouTube yang memiliki hak atas koleksi aset. Jika suatu aplikasi menggunakan YouTube Content ID API, aplikasi tersebut harus memiliki otorisasi dari pemilik konten atas aset, kebijakan, dan klaim yang dibuat atau dimanipulasinya. Otorisasi menerima otorisasi tersebut ketika pengguna aplikasi yang diautentikasi memiliki akses ke akun pemilik konten. Jika pengguna yang diautentikasi tidak memiliki akses ke akun pemilik konten, panggilan ke Content ID API akan gagal.
Mengambil ID pemilik konten
Untuk mengambil ID pemilik konten, panggil metode contentOwners.list YouTube Content ID API. Respons API berisi daftar resource contentOwner yang terkait dengan pengguna yang memberikan otorisasi permintaan. Di setiap resource, properti id menentukan ID pemilik konten.
Untuk contoh yang mengambil ID pemilik konten secara terprogram, lihat Mengupload dan Mengklaim Video.
Memanggil YouTube API atas nama pemilik konten
API Content ID YouTube
Karena sebagian besar pengguna memiliki akses ke satu akun pemilik konten, Content ID API dapat secara implisit menentukan pemilik konten yang bertindak sebagai pengguna. Dengan demikian, parameter onBehalfOfContentOwner bersifat opsional untuk panggilan Content ID API.
Namun, beberapa pengguna memiliki akses ke beberapa akun pemilik konten. Untuk pengguna ini, setiap permintaan API harus menyertakan parameter onBehalfOfContentOwner untuk mengidentifikasi secara eksplisit akun pemilik konten yang akan digunakan.
YouTube Data API (v3)
Banyak metode YouTube Data API juga mendukung parameter onBehalfOfContentOwner. Metode yang menggunakan parameter tersebut menerapkan delegasi, yang memungkinkan aplikasi melakukan tindakan baik pada saluran yang dikelola oleh pemilik konten, pada video di saluran yang dikelola tersebut, atau di resource API lainnya.
Saat menggunakan delegasi di YouTube Data API, parameter onBehalfOfContentOwner selalu diperlukan. Nilai parameter adalah ID yang secara unik mengidentifikasi pemilik konten. Anda dapat mengambil ID secara terprogram dengan memanggil metode contentOwners.list API Content ID YouTube.
Beberapa panggilan API juga memerlukan parameter delegasi tambahan. Daftar di bawah ini menjelaskan dua contoh:
- Metode
videos.insert()mengharuskan parameteronBehalfOfContentOwnerdanonBehalfOfContentOwnerChanneldisetel saat pengguna melakukan tindakan di saluran sebagai pemilik konten. Video baru diupload ke channel yang ditentukan oleh nilai parameteronBehalfOfContentOwnerChannel. - Metode
search.list()memerlukan penetapan parameteronBehalfOfContentOwnerdanforContentOwner. Dalam hal ini, parameterforContentOwnermemungkinkan pengguna memerintahkan API untuk hanya menampilkan resource milik pemilik konten yang ditentukan parameteronBehalfOfContentOwner.
Dokumentasi untuk setiap metode tertentu menjelaskan kapan metode tersebut mendukung delegasi dan apakah Anda perlu menetapkan parameter tambahan selain onBehalfOfContentOwner.
YouTube Analytics API
Untuk mengambil laporan pemilik konten menggunakan YouTube Analytics API, tetapkan nilai parameter ids dalam permintaan API ke contentOwner==OWNER_ID, dengan OWNER_ID menentukan ID pemilik konten.