Halaman ini diterjemahkan oleh Cloud Translation API.

PlaylistItems

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 tersebut.

YouTube juga menggunakan playlist untuk mengidentifikasi daftar video yang diupload di 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 ke 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 yang ditentukan 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 dalam resource ini:

Properti
`kind`	`string` Mengidentifikasi jenis resource API. Nilainya akan menjadi `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 ditentukan dalam format ISO 8601.
`snippet.channelId`	`string` ID yang digunakan YouTube untuk mengidentifikasi pengguna yang menambahkan item ke playlist secara unik.
`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: `default` – Gambar thumbnail default. Thumbnail default untuk video – atau resource yang merujuk ke video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran memiliki lebar 88 piksel dan tinggi 88 piksel. `medium` – Versi gambar thumbnail dengan resolusi lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320 px dan tinggi 180 px. Untuk channel, gambar ini berukuran lebar 240 piksel dan tinggi 240 piksel. `high` – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau referensi yang merujuk ke video), gambar ini memiliki lebar 480 px dan tinggi 360 px. Untuk channel, gambar ini berukuran lebar 800 piksel dan tinggi 800 piksel. `standard` – Versi gambar thumbnail dengan resolusi yang lebih tinggi daripada gambar resolusi `high`. Gambar ini tersedia untuk beberapa video dan resource lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640 piksel dan tinggi 480 piksel. `maxres` – Versi gambar thumbnail dengan resolusi tertinggi. Ukuran gambar ini tersedia untuk beberapa video dan referensi lainnya yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini berukuran lebar 1280 piksel dan tinggi 720 piksel.
`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 berisi item playlist.
`snippet.videoOwnerChannelTitle`	`string` Judul channel yang mengupload video ini.
`snippet.videoOwnerChannelId`	`string` ID channel channel yang mengupload video ini.
`snippet.playlistId`	`string` ID yang digunakan YouTube untuk mengidentifikasi secara unik daftar putar tempat item daftar putar berada.
`snippet.position`	`unsigned integer` Urutan kemunculan item dalam playlist. Nilainya 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 yang disertakan dalam playlist sebagai item playlist secara unik.
`snippet.resourceId.kind`	`string` Jenis, atau tipe, resource yang dirujuk.
`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 dalam playlist secara unik.
`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 detik dari awal video, saat video akan mulai diputar. (Pemilik playlist dapat menentukan waktu saat video harus mulai dan berhenti diputar 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 detik dari awal video, saat video harus berhenti diputar. (Pemilik playlist dapat menentukan waktu saat video harus mulai dan berhenti diputar 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 ke YouTube. Nilai ditentukan 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 menetapkan nilai ini menggunakan metode `videos.insert` atau `videos.update`.