Groups

Resource group mewakili grup YouTube Analytics, yang merupakan koleksi kustom yang berisi hingga 500 channel, video, playlist, atau aset.

Semua item dalam grup harus merepresentasikan jenis resource yang sama. Misalnya, Anda tidak dapat membuat grup yang berisi 100 video dan 100 playlist.

Grup Analytics hanya dapat berisi resource yang telah Anda upload atau klaim atau yang ditautkan ke channel yang Anda kelola. Oleh karena itu, pemilik channel dapat membuat grup video dan playlist. Pemilik konten dapat membuat grup video, playlist, channel, atau aset.

Metode

API ini mendukung metode berikut untuk resource groups:

list
Menampilkan daftar grup yang cocok dengan parameter permintaan API. Misalnya, Anda dapat mengambil semua grup yang dimiliki pengguna terautentikasi, atau Anda dapat mengambil satu atau beberapa grup berdasarkan ID uniknya. Coba sekarang.
insert
Membuat grup YouTube Analytics. Setelah membuat grup, gunakan metode groupItems.insert untuk menambahkan item ke grup. Coba sekarang.
update
Mengubah 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.) Coba sekarang.
hapus
Menghapus grup. Coba sekarang.

Representasi resource

Struktur JSON di bawah menunjukkan format resource groups:

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

Properti

Tabel berikut menentukan properti yang muncul dalam resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#group.
etag etag
Etag resource ini.
id string
ID yang digunakan YouTube untuk mengidentifikasi grup secara unik.
snippet object
Objek snippet berisi informasi dasar tentang grup, termasuk tanggal pembuatan dan namanya.
snippet.publishedAt datetime
Tanggal dan waktu grup dibuat. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.title string
Nama grup. Nilai harus berupa string yang tidak kosong.
contentDetails object
Objek contentDetails berisi informasi tambahan tentang grup, seperti jumlah dan jenis item yang dikandungnya.
contentDetails.itemCount unsigned long
Jumlah item dalam grup.
contentDetails.itemType string
Jenis resource yang terdapat dalam grup.

Nilai yang valid untuk properti ini adalah:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset