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 referensi yang disertakan, yang secara khusus berkaitan dengan cara 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 itu dari channel resource untuk channel tertentu. Selanjutnya, Anda dapat menggunakan metode playlistItems.list untuk daftar tersebut.

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 tertentu, atau mengambil satu atau beberapa item playlist dengan ID uniknya. Coba sekarang.
sisipkan: Menambahkan referensi 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 menampilkan 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 mendefinisikan properti yang muncul di resource ini:

Properti
`kind`	`string` Mengidentifikasi jenis resource API. Nilainya akan berupa `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 secara unik pengguna 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 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 merujuk ke video, seperti item playlist atau hasil penelusuran – adalah lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran adalah lebar 88px dan tinggi 88px. `medium` – Versi gambar thumbnail beresolusi lebih tinggi. Untuk video (atau sumber daya yang merujuk pada video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px. `high` – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau sumber daya yang merujuk pada video), gambar ini memiliki lebar 480px dan tinggi 360px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel. `standard` – Versi gambar thumbnail beresolusi lebih tinggi daripada gambar beresolusi `high`. Gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640px dan tinggi 480px. `maxres` – Versi gambar thumbnail dengan resolusi tertinggi. Ukuran gambar ini tersedia untuk beberapa video dan resource lain yang merujuk ke 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 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 secara unik yang berisi item playlist tersebut.
`snippet.position`	`unsigned integer` Urutan kemunculan item di playlist. Nilai ini 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 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 referensi jika item yang disertakan adalah video YouTube. Objek berisi informasi tambahan tentang video.
`contentDetails.videoId`	`string` ID yang digunakan YouTube untuk mengidentifikasi video secara unik. Untuk mengambil resource `video`, setel 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 seharusnya mulai diputar. (Pemilik playlist dapat menentukan kapan video harus mulai dan berhenti 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 kapan video harus mulai dan berhenti diputar dalam konteks playlist.) Secara default, asumsikan bahwa `video.endTime` adalah bagian 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 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`.