Memodifikasi metadata untuk grup. Saat ini, satu-satunya properti yang dapat diperbarui adalah judul grup. (Gunakan groupItems.insert dan groupItems.delete untuk menambahkan dan menghapus item grup.)
Permintaan
Permintaan HTTP
PUT https://youtubeanalytics.googleapis.com/v2/groups
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).
| Cakupan | |
|---|---|
| https://www.googleapis.com/auth/yt-analytics.readonly | Melihat 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 | Melihat laporan moneter YouTube Analytics untuk konten YouTube Anda. Cakupan ini memberikan akses ke metrik aktivitas pengguna serta estimasi pendapatan dan 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 serta 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 |
stringParameter ini hanya dapat digunakan dalam permintaan yang diotorisasi dengan benar. Catatan: Parameter ini ditujukan secara eksklusif untuk partner konten YouTube yang memiliki dan mengelola banyak channel YouTube yang berbeda. Parameter onBehalfOfContentOwner menunjukkan bahwa kredensial otorisasi permintaan mengidentifikasi pengguna YouTube yang bertindak atas nama pemilik konten yang ditentukan dalam nilai parameter. Fitur ini memungkinkan pemilik konten melakukan autentikasi satu kali dan mendapatkan akses ke semua data video dan channel mereka, tanpa harus memberikan kredensial autentikasi untuk setiap channel. Akun yang digunakan pengguna untuk melakukan autentikasi harus ditautkan ke pemilik konten YouTube yang ditentukan. |
|
Isi permintaan
Berikan resource grup dalam isi permintaan.
Untuk resource tersebut, Anda harus menentukan nilai untuk properti berikut. Perhatikan bahwa permintaan memperbarui nilai kolom snippet.title.
idsnippet.title
Respons
Jika berhasil, metode ini akan menampilkan resource grup dalam isi respons.
Error
API tidak menentukan pesan error apa pun yang unik untuk metode API ini. Namun, metode ini masih dapat menampilkan error API umum yang tercantum dalam dokumentasi pesan error.
Cobalah!
Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan serta respons API.