GroupItems: list

Penting: Permintaan API ke metode ini memerlukan akses ke:
  • cakupan https://www.googleapis.com/auth/youtube
    atau
  • cakupan https://www.googleapis.com/auth/youtube.readonly
    dan
    cakupan https://www.googleapis.com/auth/yt-analytics.readonly

Opsi pertama menggunakan satu cakupan, yang kebetulan adalah cakupan baca-tulis, sedangkan opsi kedua menggunakan dua cakupan hanya baca.

Menampilkan kumpulan item grup yang cocok dengan parameter permintaan API.

Permintaan

Permintaan HTTP

GET 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 yang diperlukan
groupId string
Parameter id menentukan ID unik grup yang item grupnya ingin Anda ambil.
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

Jangan berikan isi permintaan saat memanggil metode ini.

Tanggapan

Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#groupItemListResponse.
etag etag
Etag resource ini.
items[] list
Daftar item yang dimiliki grup. Setiap item dalam daftar mewakili resource groupItem.

Error

API tidak menetapkan pesan error apa pun yang unik untuk metode API ini. Namun, metode ini tetap dapat menampilkan error API umum yang tercantum dalam dokumentasi pesan error.

Cobalah!

Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan dan respons API.