PlaylistItems

Resource playlistItem mengidentifikasi resource lain, seperti video, yang disertakan dalam playlist. Selain itu, resource playlistItem berisi detail tentang resource yang disertakan yang secara spesifik berkaitan dengan 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 tersebut dari channel resource untuk saluran tertentu. Lalu, Anda dapat menggunakan metode playlistItems.list ke daftar.

Metode

API 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.
masukkan
Menambahkan resource 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 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 di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah 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 ditetapkan dalam format ISO 8601.
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi pengguna secara unik 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 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 pada video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk channel adalah lebar 88 piksel dan tinggi 88 piksel.
  • medium – Versi gambar thumbnail yang beresolusi lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px.
  • high – Versi thumbnail dengan resolusi tinggi. Untuk video (atau resource 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 resolusi high. Gambar ini tersedia untuk beberapa video dan resource lain yang mengacu pada video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640 piksel dan tinggi 480 piksel.
  • maxres – Versi gambar thumbnail 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 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 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 berisi item playlist secara unik.
snippet.position unsigned integer
Urutan kemunculan item di playlist. Nilai 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 direferensikan.
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 secara unik dalam playlist.
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 hitungan detik sejak awal video, saat video akan mulai diputar. (Pemilik playlist dapat menentukan waktu untuk memulai dan menghentikan pemutaran 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 hitungan detik dari awal video, saat video harus berhenti diputar. (Pemilik playlist dapat menentukan waktu untuk memulai dan menghentikan pemutaran 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 di YouTube. Nilai ditetapkan 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 menyetel nilai ini menggunakan metode videos.insert atau videos.update.