Resource playlistItem
mengidentifikasi resource lain, seperti
video, yang disertakan dalam playlist. Selain itu, resource playlistItem
berisi detail tentang resource yang disertakan yang secara spesifik berkaitan dengan penggunaan resource tersebut dalam playlist tersebut.
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 channel resource
untuk saluran tertentu. Lalu, Anda dapat menggunakan metode playlistItems.list
ke daftar.
Metode
API 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 yang ditentukan atau mengambil satu atau beberapa item playlist berdasarkan ID uniknya. Coba sekarang.
- masukkan
- Menambahkan resource ke playlist. Coba sekarang.
- perbarui
- Memodifikasi item playlist. Misalnya, Anda dapat memperbarui posisi item di 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 |
string Mengidentifikasi jenis resource API. Nilainya adalah youtube#playlistItem . |
etag |
etag Etag resource ini. |
id |
string ID yang digunakan YouTube untuk mengidentifikasi item playlist secara unik. |
snippet |
object Objek snippet berisi detail dasar tentang item playlist, seperti judul dan posisinya dalam playlist. |
snippet.publishedAt |
datetime Tanggal dan waktu item ditambahkan ke playlist. Nilai ditetapkan dalam format ISO 8601. |
snippet.channelId |
string ID yang digunakan YouTube untuk mengidentifikasi pengguna secara unik yang menambahkan item ke playlist. |
snippet.title |
string Judul item. |
snippet.description |
string Deskripsi item. |
snippet.thumbnails |
object Peta gambar thumbnail yang terkait dengan item playlist. Untuk setiap objek di peta, kuncinya adalah nama gambar thumbnail, dan nilainya adalah objek yang berisi informasi lain tentang thumbnail. |
snippet.thumbnails.(key) |
object Nilai kunci yang valid adalah:
|
snippet.thumbnails.(key).url |
string URL gambar. |
snippet.thumbnails.(key).width |
unsigned integer Lebar gambar. |
snippet.thumbnails.(key).height |
unsigned integer Tinggi gambar. |
snippet.channelTitle |
string Judul channel tempat item playlist berada. |
snippet.videoOwnerChannelTitle |
string Judul channel yang mengupload video ini. |
snippet.videoOwnerChannelId |
string ID channel yang mengupload video ini. |
snippet.playlistId |
string ID yang digunakan YouTube untuk mengidentifikasi playlist berisi item playlist secara unik. |
snippet.position |
unsigned integer Urutan kemunculan item di playlist. Nilai menggunakan indeks berbasis nol, sehingga item pertama memiliki posisi 0 , item kedua memiliki posisi 1 , dan seterusnya. |
snippet.resourceId |
object Objek id berisi informasi yang dapat digunakan untuk mengidentifikasi resource secara unik yang disertakan dalam playlist sebagai item playlist. |
snippet.resourceId.kind |
string Jenis, atau jenis, resource yang direferensikan. |
snippet.resourceId.videoId |
string Jika 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 playlist. |
contentDetails |
object Objek contentDetails disertakan dalam resource jika item yang disertakan adalah video YouTube. Objek ini berisi informasi tambahan tentang video. |
contentDetails.videoId |
string ID 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 |
string Catatan: Properti ini tidak digunakan lagi dan, jika ditetapkan, nilainya akan diabaikan. Waktu, yang diukur dalam hitungan detik sejak awal video, saat video akan mulai diputar. (Pemilik playlist dapat menentukan waktu untuk memulai dan menghentikan pemutaran saat video diputar dalam konteks playlist.) Nilai defaultnya adalah 0 . |
contentDetails.endAt |
string Catatan: Properti ini tidak digunakan lagi dan, jika ditetapkan, nilainya akan diabaikan. Waktu, yang diukur dalam hitungan detik dari awal video, saat video harus berhenti diputar. (Pemilik playlist dapat menentukan waktu untuk memulai dan menghentikan pemutaran saat video diputar dalam konteks playlist.) Secara default, asumsikan bahwa video.endTime adalah akhir video. |
contentDetails.note |
string Catatan buatan pengguna untuk item ini. Nilai properti memiliki panjang maksimum 280 karakter. |
contentDetails.videoPublishedAt |
datetime Tanggal dan waktu video dipublikasikan di YouTube. Nilai ditetapkan dalam format ISO 8601. |
status |
object Objek status berisi informasi tentang status privasi item playlist. |
status.privacyStatus |
string Status privasi item playlist. Channel yang mengupload video yang diwakili oleh item playlist dapat menyetel nilai ini menggunakan metode videos.insert atau videos.update . |