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 disetel untuk publik atau pribadi.
YouTube juga menggunakan playlist untuk mengidentifikasi koleksi video khusus untuk channel, seperti:
- video yang diupload
- video dengan rating positif (disukai)
channel resource
untuk saluran tertentu.Anda kemudian dapat menggunakan metode
playlistItems.list
untuk mengambil salah satu dari daftar tersebut. Anda juga dapat menambahkan atau menghapus item dari daftar tersebut dengan memanggil metode playlistItems.insert
dan playlistItems.delete
.
Metode
API mendukung metode berikut untuk resource playlists
:
- list
- Menampilkan koleksi playlist yang cocok dengan parameter permintaan API. Misalnya, Anda dapat mengambil semua playlist yang dimiliki pengguna terautentikasi, atau Anda dapat mengambil satu atau beberapa playlist menurut ID uniknya. Coba sekarang.
- masukkan
- 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 menunjukkan 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 menentukan properti yang muncul di resource ini:
Properti | |
---|---|
kind |
string Mengidentifikasi jenis resource API. Nilainya adalah 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 ditetapkan dalam format ISO 8601. |
snippet.channelId |
string ID yang digunakan YouTube untuk mengidentifikasi channel yang memublikasikan playlist secara unik. |
snippet.title |
string Judul playlist. |
snippet.description |
string Deskripsi playlist. |
snippet.thumbnails |
object Peta gambar thumbnail yang terkait dengan 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 yang mencakup video tersebut. |
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. |