Resource playlist
mewakili playlist YouTube. Playlist adalah kumpulan video yang dapat ditonton secara berurutan dan dibagikan kepada pengguna lain. Secara default, playlist dapat dilihat oleh pengguna lain, tetapi playlist dapat bersifat publik atau pribadi.
YouTube juga menggunakan playlist untuk mengidentifikasi koleksi video khusus untuk suatu channel, seperti:
- video yang diupload
- video yang diberi rating (disukai) secara positif
channel resource
untuk channel tertentu.Anda kemudian dapat menggunakan metode
playlistItems.list
untuk mengambil salah satu daftar tersebut. Anda juga dapat menambahkan atau menghapus item dari daftar tersebut dengan memanggil metode playlistItems.insert
dan playlistItems.delete
.
Metode
API ini mendukung metode berikut untuk resource playlists
:
- list
- Menampilkan kumpulan playlist yang cocok dengan parameter permintaan API. Misalnya, Anda dapat mengambil semua playlist yang dimiliki pengguna yang diautentikasi, atau Anda dapat mengambil satu atau beberapa playlist berdasarkan ID uniknya. Coba sekarang.
- sisipkan
- Membuat playlist. Coba sekarang.
- perbarui
- Memodifikasi playlist. Misalnya, Anda dapat mengubah judul, deskripsi, atau status privasi playlist. Coba sekarang.
- hapus
- Menghapus playlist. Coba sekarang.
Representasi resource
Struktur JSON berikut menampilkan format resource playlists
:
{ "kind": "youtube#playlist", "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, "defaultLanguage": string, "localized": { "title": string, "description": string } }, "status": { "privacyStatus": string }, "contentDetails": { "itemCount": unsigned integer }, "player": { "embedHtml": string }, "localizations": { (key): { "title": string, "description": string } } }
Properti
Tabel berikut mendefinisikan properti yang muncul di resource ini:
Properti | |
---|---|
kind |
string Mengidentifikasi jenis resource API. Nilainya akan berupa youtube#playlist . |
etag |
etag Etag resource ini. |
id |
string ID yang digunakan YouTube untuk mengidentifikasi playlist secara unik. |
snippet |
object Objek snippet berisi detail dasar tentang playlist, seperti judul dan deskripsinya. |
snippet.publishedAt |
datetime Tanggal dan waktu playlist dibuat. Nilai ditentukan dalam format ISO 8601. |
snippet.channelId |
string ID yang digunakan YouTube untuk mengidentifikasi secara unik channel yang memublikasikan playlist. |
snippet.title |
string Judul playlist. |
snippet.description |
string Deskripsi playlist. |
snippet.thumbnails |
object Peta gambar thumbnail yang terkait dengan playlist. Untuk setiap objek dalam 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 video tersebut berada. |
snippet.tags[] |
list Properti ini tidak digunakan lagi. Tag kata kunci yang terkait dengan playlist. |
snippet.defaultLanguage |
string Bahasa teks di properti snippet.title dan snippet.description resource playlist . |
snippet.localized |
object Objek snippet.localized berisi judul dan deskripsi yang dilokalkan untuk playlist atau judul dalam bahasa default untuk metadata playlist.
localizations untuk menambahkan, memperbarui, atau menghapus judul yang dilokalkan. |
snippet.localized.title |
string Judul playlist yang dilokalkan. |
snippet.localized.description |
string Deskripsi playlist yang dilokalkan. |
status |
object Objek status berisi informasi status untuk playlist. |
status.privacyStatus |
string Status privasi playlist. Nilai yang valid untuk properti ini adalah:
|
contentDetails |
object Objek contentDetails berisi informasi tentang konten playlist, termasuk jumlah video dalam playlist. |
contentDetails.itemCount |
unsigned integer Jumlah video dalam playlist. |
player |
object Objek player berisi informasi yang akan Anda gunakan untuk memutar playlist di pemutar tersemat. |
player.embedHtml |
string Tag <iframe> yang menyematkan pemutar yang akan memutar playlist. |
localizations |
object Objek localizations mengenkapsulasi terjemahan metadata playlist. |
localizations.(key) |
object Bahasa teks yang dilokalkan yang terkait dengan nilai kunci. Nilainya adalah string yang berisi kode bahasa BCP-47. |
localizations.(key).title |
string Judul playlist yang dilokalkan. |
localizations.(key).description |
string Deskripsi playlist yang dilokalkan. |