Halaman ini diterjemahkan oleh Cloud Translation API.

Playlists

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 secara publik, tetapi playlist dapat bersifat publik atau pribadi.

YouTube juga menggunakan playlist untuk mengidentifikasi koleksi video khusus untuk suatu channel, seperti:

video yang diupload
Video dengan rating positif (disukai)

Lebih spesifiknya, daftar ini dikaitkan dengan channel, yang merupakan kumpulan video, playlist, dan informasi YouTube lainnya milik seseorang, grup, atau perusahaan. Anda dapat mengambil ID playlist untuk setiap daftar ini dari 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 koleksi playlist yang cocok dengan parameter permintaan API. Misalnya, Anda dapat mengambil semua playlist yang dimiliki pengguna terautentikasi, atau mengambil satu atau beberapa playlist berdasarkan ID uniknya. Coba sekarang.
sisipkan: Membuat playlist. Coba sekarang.
info terbaru: 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,
    "podcastStatus": enum
  },
  "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 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: `default` – Gambar thumbnail default. Thumbnail default untuk video – atau referensi yang mengacu pada video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk sebuah channel memiliki lebar 88 piksel dan tinggi 88 piksel. `medium` – Versi resolusi gambar thumbnail yang lebih tinggi. Untuk video (atau referensi yang merujuk pada video), gambar ini memiliki lebar 320 piksel dan tinggi 180 piksel. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px. `high` – Gambar thumbnail versi resolusi tinggi. Untuk video (atau referensi yang merujuk pada video), gambar ini memiliki lebar 480 piksel dan tinggi 360 piksel. Untuk channel, gambar ini memiliki lebar 800px dan tinggi 800px. `standard` – Versi gambar thumbnail beresolusi lebih tinggi dibandingkan gambar beresolusi `high`. Gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk pada video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640px dan tinggi 480px. `maxres` – Versi resolusi tertinggi untuk gambar thumbnail. Ukuran gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk pada video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 1280px dan tinggi 720px.
`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 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. Teks yang dilokalkan ditampilkan dalam cuplikan resource jika permintaan `playlists.list` menggunakan parameter `hl` untuk menentukan bahasa yang akan menampilkan teks yang dilokalkan dan teks yang dilokalkan tersedia dalam bahasa tersebut. Metadata untuk bahasa default ditampilkan jika nilai parameter `hl` tidak ditentukan atau nilai ditentukan, tetapi metadata yang dilokalkan tidak tersedia untuk bahasa yang ditentukan. Properti berisi nilai hanya baca. Gunakan objek `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: `private` `public` `unlisted`
`status.podcastStatus`	`string` Status podcast playlist. Jika nilainya `enabled`, playlist akan ditandai sebagai acara podcast. Untuk menyetel status podcast playlist ke `enabled`, playlist harus memiliki gambar playlist. Nilai yang valid untuk properti ini adalah: `enabled` `disabled` `unspecified`
`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` merangkum terjemahan metadata playlist.
`localizations.(key)`	`object` Bahasa teks lokal 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.