Resource playlistItem mengidentifikasi resource lain, seperti
video, yang disertakan dalam playlist. Selain itu, resource playlistItem
berisi detail tentang resource yang disertakan yang secara khusus berkaitan dengan cara resource
tersebut digunakan dalam playlist itu.
YouTube juga menggunakan playlist untuk mengidentifikasi daftar video yang diupload channel, dengan setiap
playlistItem dalam daftar tersebut mewakili satu video yang diupload. Anda dapat mengambil
ID playlist untuk daftar tersebut dari resource channel
untuk saluran tertentu. Kemudian, Anda dapat menggunakan
metode playlistItems.list untuk
daftar.
Metode
API ini mendukung metode berikut untuk resource playlistItems:
- list
- Menampilkan kumpulan item playlist yang cocok dengan parameter permintaan API. Anda dapat mengambil semua item playlist dalam playlist tertentu atau mengambil satu atau beberapa item playlist berdasarkan ID uniknya. Coba sekarang.
- insert
- Menambahkan materi ke playlist. Coba sekarang.
- update
- Mengubah item playlist. Misalnya, Anda dapat memperbarui posisi item dalam playlist. Coba sekarang.
- hapus
- Menghapus item playlist. Coba sekarang.
Representasi resource
Struktur JSON berikut menunjukkan format resource playlistItems:
{
"kind": "youtube#playlistItem",
"etag": etag,
"id": string,
"snippet": {
"publishedAt": datetime,
"channelId": string,
"title": string,
"description": string,
"thumbnails": {
(key): {
"url": string,
"width": unsigned integer,
"height": unsigned integer
}
},
"channelTitle": string,
"videoOwnerChannelTitle": string,
"videoOwnerChannelId": string,
"playlistId": string,
"position": unsigned integer,
"resourceId": {
"kind": string,
"videoId": string,
}
},
"contentDetails": {
"videoId": string,
"startAt": string,
"endAt": string,
"note": string,
"videoPublishedAt": datetime
},
"status": {
"privacyStatus": string
}
}Properti
Tabel berikut menentukan properti yang muncul di resource ini:
| Properti | |
|---|---|
kind |
stringMengidentifikasi jenis resource API. Nilainya adalah youtube#playlistItem. |
etag |
etagETag resource ini. |
id |
stringID yang digunakan YouTube untuk mengidentifikasi item daftar putar secara unik. |
snippet |
objectObjek snippet berisi detail dasar tentang item playlist, seperti judul dan posisinya dalam playlist. |
snippet.publishedAt |
datetimeTanggal dan waktu item ditambahkan ke playlist. Nilai ditentukan dalam format ISO 8601. |
snippet.channelId |
stringID yang digunakan YouTube untuk mengidentifikasi secara unik pengguna yang menambahkan item ke playlist. |
snippet.title |
stringJudul item. |
snippet.description |
stringDeskripsi item. |
snippet.thumbnails |
objectPeta gambar thumbnail yang terkait dengan item playlist. Untuk setiap objek dalam peta, kuncinya adalah nama gambar thumbnail, dan nilainya adalah objek yang berisi informasi lain tentang thumbnail. |
snippet.thumbnails.(key) |
objectNilai kunci yang valid adalah:
|
snippet.thumbnails.(key).url |
stringURL gambar. |
snippet.thumbnails.(key).width |
unsigned integerLebar gambar. |
snippet.thumbnails.(key).height |
unsigned integerTinggi gambar. |
snippet.channelTitle |
stringJudul channel yang memiliki item playlist. |
snippet.videoOwnerChannelTitle |
stringJudul channel yang mengupload video ini. |
snippet.videoOwnerChannelId |
stringID channel yang mengupload video ini. |
snippet.playlistId |
stringID yang digunakan YouTube untuk mengidentifikasi secara unik daftar putar yang berisi item daftar putar. |
snippet.position |
unsigned integerUrutan item muncul dalam daftar putar. Nilai menggunakan indeks berbasis nol, sehingga item pertama memiliki posisi 0, item kedua memiliki posisi 1, dan seterusnya. |
snippet.resourceId |
objectObjek id berisi informasi yang dapat digunakan untuk mengidentifikasi secara unik resource yang disertakan dalam daftar putar sebagai item daftar putar. |
snippet.resourceId.kind |
stringJenis, atau tipe, resource yang dirujuk. |
snippet.resourceId.videoId |
stringJika nilai properti snippet.resourceId.kind adalah youtube#video, properti ini akan ada dan nilainya akan berisi ID yang digunakan YouTube untuk mengidentifikasi video secara unik dalam daftar putar. |
contentDetails |
objectObjek contentDetails disertakan dalam resource jika item yang disertakan adalah video YouTube. Objek ini berisi informasi tambahan tentang video. |
contentDetails.videoId |
stringID yang digunakan YouTube untuk mengidentifikasi video secara unik. Untuk mengambil resource video, tetapkan parameter kueri id ke nilai ini dalam permintaan API Anda. |
contentDetails.startAt |
stringCatatan: Properti ini sudah tidak digunakan lagi dan, jika disetel, nilainya akan diabaikan. Waktu, yang diukur dalam detik dari awal video, saat video harus mulai diputar. (Pemilik playlist dapat menentukan waktu mulai dan berhenti pemutaran video saat video diputar dalam konteks playlist.) Nilai defaultnya adalah 0. |
contentDetails.endAt |
stringCatatan: Properti ini sudah tidak digunakan lagi dan, jika disetel, nilainya akan diabaikan. Waktu, diukur dalam detik dari awal video, saat video harus berhenti diputar. (Pemilik playlist dapat menentukan waktu mulai dan berhenti pemutaran video saat video diputar dalam konteks playlist.) Secara default, asumsikan bahwa video.endTime adalah akhir video. |
contentDetails.note |
stringCatatan buatan pengguna untuk item ini. Nilai properti memiliki panjang maksimum 280 karakter. |
contentDetails.videoPublishedAt |
datetimeTanggal dan waktu video dipublikasikan ke YouTube. Nilai ditentukan dalam format ISO 8601. |
status |
objectObjek status berisi informasi tentang status privasi item playlist. |
status.privacyStatus |
stringStatus privasi item playlist. Channel yang mengupload video yang diwakili oleh item playlist dapat menyetel nilai ini menggunakan metode videos.insert atau videos.update. |