Membuat item grup.
Permintaan
Permintaan HTTP
POST https://youtubeanalytics.googleapis.com/v2/groupItems
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).
Cakupan | |
---|---|
https://www.googleapis.com/auth/yt-analytics.readonly | Lihat laporan YouTube Analytics untuk konten YouTube Anda. Cakupan ini memberikan akses ke metrik aktivitas pengguna, seperti jumlah penayangan dan jumlah rating. |
https://www.googleapis.com/auth/yt-analytics-monetary.readonly | Lihat laporan moneter YouTube Analytics untuk konten YouTube Anda. Cakupan ini memberikan akses ke metrik aktivitas pengguna dan estimasi pendapatan serta metrik performa iklan. |
https://www.googleapis.com/auth/youtube | Mengelola akun YouTube Anda. Di YouTube Analytics API, pemilik channel menggunakan cakupan ini untuk mengelola grup dan item grup YouTube Analytics. |
https://www.googleapis.com/auth/youtubepartner | Melihat dan mengelola aset YouTube dan konten terkait di YouTube. Di YouTube Analytics API, pemilik konten menggunakan cakupan ini untuk mengelola grup dan item grup YouTube Analytics. |
Parameter
Tabel di bawah mencantumkan parameter yang didukung kueri ini. Semua parameter yang tercantum adalah parameter kueri.
Parameter | ||
---|---|---|
Parameter opsional | ||
onBehalfOfContentOwner |
string Parameter ini hanya dapat digunakan dalam permintaan yang diizinkan dengan benar. Catatan: Parameter ini ditujukan secara eksklusif untuk partner konten YouTube yang memiliki dan mengelola berbagai channel YouTube. Parameter onBehalfOfContentOwner menunjukkan bahwa kredensial otorisasi permintaan mengidentifikasi pengguna YouTube yang bertindak atas nama pemilik konten yang ditentukan dalam nilai parameter. Dengan kebijakan ini, pemilik konten dapat mengautentikasi sekali serta mendapatkan akses ke semua data video dan channel mereka, tanpa harus memberikan kredensial autentikasi untuk setiap channel. Akun yang diautentikasi pengguna harus ditautkan dengan pemilik konten YouTube yang ditentukan. |
Isi permintaan
Berikan resource groupItem di isi permintaan. Untuk resource tersebut, Anda harus menentukan nilai untuk properti berikut.
groupId
resource.id
Tanggapan
Jika item berhasil disisipkan, metode ini akan menampilkan resource groupItem dalam isi respons.
Jika item yang ditentukan dalam permintaan sudah disertakan dalam grup sebelum permintaan dibuat, metode ini akan menampilkan kode respons 204
HTTP (No Content
).
Error
Tabel di bawah mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk mengetahui detail selengkapnya.
Jenis error | Detail error | Deskripsi |
---|---|---|
forbidden (403) |
groupContainsMaximumNumberOfItems |
Grup berisi jumlah item maksimum yang diizinkan. |
Cobalah!
Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan dan respons API.