Contoh berikut menunjukkan cara menggunakan YouTube Data API (v3) untuk menjalankan fungsi yang terkait dengan playlist dan item playlist.
Mengambil playlist pengguna saat ini
Panggil metode playlists.list
untuk mengambil playlist pengguna yang saat ini diautentikasi. Dalam permintaan Anda, setel nilai parameter mine
ke true
. Perlu diperhatikan bahwa permintaan yang menggunakan parameter mine
harus diizinkan menggunakan OAuth 2.0.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list? part=snippet,contentDetails &mine=true
Mengambil playlist pengguna
Contoh ini mengambil playlist yang dibuat oleh channel tertentu. Contoh ini memiliki dua langkah:
-
Langkah 1: Mengambil ID channel
Panggil metode
channels.list
untuk mengambil ID channel yang terkait dengan nama pengguna YouTube tertentu. (Dalam contoh ini, nama pengguna adalahGoogleDevelopers
.) Di respons API, propertiid
mengidentifikasi ID saluran.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=id &forUsername=GoogleDevelopers
-
Langkah 2: Mengambil playlist channel
Panggil metode
playlists.list
untuk mengambil playlist channel. Tetapkan nilai parameterchannelId
ke nilai yang diperoleh di langkah 1.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list? part=snippet,contentDetails &channelId=UC_x5XG1OV2P6uZZ5FSM9Ttw
Mengambil informasi tentang playlist tertentu
Untuk mengambil informasi tentang satu atau beberapa playlist tertentu, panggil metode playlists.list
dan tetapkan parameter id
ke daftar ID playlist YouTube yang dipisahkan koma yang mengidentifikasi resource yang diinginkan. Kasus penggunaan umum untuk fungsi ini adalah permintaan untuk mengambil informasi tambahan tentang sekumpulan playlist yang ditampilkan dalam kumpulan hasil penelusuran. Misalnya, Anda mungkin ingin mengambil jumlah item di setiap playlist.
Permintaan di bawah ini memanggil metode playlists.list
untuk mengambil jumlah item dalam dua playlist yang cocok dengan istilah kueri "GoogleDevelopers". Informasi ini ada di properti contentDetails.itemCount
resource playlist
, sehingga permintaan menetapkan nilai parameter part
ke contentDetails
.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.list? part=contentDetails &id=PLOU2XLYxmsIIM9h1Ybw2DuRw6o2fkNMeR,PLyYlLs02rgBYRWBzYpoHz7m2SE8mEZ68w
Menambahkan playlist
Contoh ini memanggil metode playlists.insert
untuk membuat playlist pribadi di channel pengguna yang diautentikasi. Semua permintaan API ke metode ini harus diotorisasi menggunakan OAuth 2.0.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.insert? part=snippet,status
Link ke APIs Explorer juga menyetel parameter yang menentukan isi permintaan API. Isi permintaan berisi resource playlist
, yang menentukan informasi seperti judul, deskripsi, dan status privasi playlist. Dalam contoh ini, isi permintaan adalah:
{ "snippet": { "title": "New playlist", "description": "New playlist description" }, "status": { "privacyStatus": "private" } }
Contoh kode terkait: Java, JavaScript, .NET, PHP, Python
Memperbarui playlist
Contoh ini memperbarui status privasi playlist dari private
menjadi public
. Contoh ini memiliki dua langkah:
-
Langkah 1: Ambil ID playlist
Panggil metode
playlist.list
untuk mengambil playlist di saluran pengguna yang saat ini diautentikasi. Contoh permintaan di atas untuk mengambil playlist pengguna saat ini menunjukkan permintaan ini. Aplikasi yang memanggil API ini dapat memproses respons API untuk menampilkan daftar playlist, menggunakan setiap ID playlist sebagai kunci. -
Langkah 2: Memperbarui playlist
Panggil metode
playlists.update
untuk mengubah playlist tertentu. Metode ini memerlukan token otorisasi OAuth 2.0 yang valid.Isi permintaan harus menyertakan bagian
snippet
resourceplaylist
karena propertisnippet.title
diperlukan saat memanggil metode ini. Selain itu, jika resource playlist yang diperbarui menentukan nilai untuk propertisnippet.description
atausnippet.tags
, nilai tersebut harus ditentukan ulang dalam permintaan pembaruan atau akan dihapus.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.update? part=snippet,status
Seperti pada contoh di atas untuk menambahkan playlist, link ke APIs Explorer menetapkan parameter yang menetapkan isi permintaan API. Isi permintaan berisi resource
playlist
, yang menentukan informasi seperti judul, deskripsi, dan status privasi playlist. Isi permintaan berikut digunakan dalam contoh ini:{ "id": "PLAYLIST_ID", "snippet": { "title": "New playlist", "description": "New playlist description" }, "status": { "privacyStatus": "public" } }
Catatan: Jika menguji kueri ini di APIs Explorer, Anda harus mengganti ID playlist yang valid ke dalam isi resource. Untuk mendapatkan ID playlist, sebaiknya jalankan permintaan yang ditampilkan di atas untuk menambahkan playlist terlebih dahulu. Ekstrak ID playlist dari respons API dan gunakan nilai tersebut untuk playlist yang ingin Anda perbarui. Judul dan deskripsi playlist yang digunakan dalam contoh ini sama dengan yang digunakan dalam contoh ini.
Menambahkan item playlist
Contoh ini menambahkan item ke playlist. Permintaan ini harus diotorisasi menggunakan OAuth 2.0. Contoh ini memiliki dua langkah:
-
Langkah 1: Ambil ID playlist yang sesuai
Panggil metode
playlist.list
untuk mengambil playlist di saluran pengguna yang saat ini diautentikasi. Contoh permintaan di atas untuk mengambil playlist pengguna saat ini menunjukkan permintaan ini. Aplikasi yang memanggil API ini dapat memproses respons API untuk menampilkan daftar playlist, menggunakan setiap ID playlist sebagai kunci. -
Langkah 2: Tambahkan video ke playlist
Panggil metode
playlistItems.insert
untuk menambahkan video ke playlist. Permintaan ini harus diotorisasi menggunakan OAuth 2.0. Isi permintaan adalah resourceplaylistItem
yang menentukan setidaknya nilai berikut:snippet.playlistId
mengidentifikasi playlist tempat Anda menambahkan video. Ini adalah ID playlist yang Anda dapatkan di langkah 1.snippet.resourceId.kind
berisi nilaiyoutube#video
.snippet.resourceId.videoId
mengidentifikasi video yang Anda tambahkan ke playlist. Nilai properti adalah ID video YouTube yang unik.
Permintaan API di bawah menambahkan video ke playlist. Isi permintaan adalah:
{ "snippet": { "playlistId": "PLAYLIST_ID", "resourceId": { "kind": "youtube#video", "videoId": "VIDEO_ID" } } }
Untuk menyelesaikan permintaan di Penjelajah API, Anda perlu menetapkan nilai untuk properti
snippet.playlistId
dansnippet.resourceId.videoId
.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.insert? part=snippet
Catatan: Dokumentasi untuk metode
playlistItems.insert
mengidentifikasi nilai properti lainnya yang dapat Anda tetapkan saat menambahkan item playlist.
Memperbarui item playlist
Contoh ini memperbarui item playlist agar merupakan item pertama dalam playlist. Permintaan ini harus diotorisasi menggunakan OAuth 2.0. Contoh ini memiliki tiga langkah:
-
Langkah 1: Ambil ID playlist yang sesuai
Panggil metode
playlist.list
untuk mengambil playlist di saluran pengguna yang saat ini diautentikasi. Contoh permintaan di atas untuk mengambil playlist pengguna saat ini menunjukkan permintaan ini. Aplikasi yang memanggil API ini dapat memproses respons API untuk menampilkan daftar playlist, menggunakan setiap ID playlist sebagai kunci. -
Langkah 2: Ambil item di playlist yang dipilih
Panggil metode
playlistItems.list
untuk mengambil daftar video di playlist yang dipilih. Setel nilai parameterplaylistId
ke ID playlist yang Anda peroleh di langkah 1.Setiap resource dalam respons API berisi properti
id
, yang mengidentifikasi ID item playlist yang mengidentifikasi item tersebut secara unik. Anda akan menggunakan nilai tersebut untuk menghapus item dari daftar di langkah berikutnya. -
Langkah 3: Perbarui item playlist yang dipilih
Panggil metode
playlistItems.update
untuk mengubah posisi video di playlist. Tetapkan nilai parameterpart
kesnippet
. Isi permintaan harus berupa resourceplaylistItem
yang setidaknya menetapkan nilai berikut:- Setel properti
id
ke ID item playlist yang diperoleh pada langkah 2. - Setel properti
snippet.playlistId
ke ID playlist yang diperoleh pada langkah 1. - Tetapkan properti
snippet.resourceId.kind
keyoutube#video
. - Setel properti
snippet.resourceId.videoId
ke ID video yang secara unik mengidentifikasi video yang disertakan dalam playlist. - Tetapkan properti
snippet.position
ke0
atau ke posisi mana pun yang Anda inginkan untuk menampilkan item (menggunakan indeks berbasis 0).
Permintaan API di bawah ini memperbarui item playlist menjadi item pertama dalam playlist. Isi permintaan adalah:
{ "id": "PLAYLIST_ITEM_ID", "snippet": { "playlistId": "PLAYLIST_ID", "resourceId": { "kind": "youtube#video", "videoId": "VIDEO_ID" }, "position": 0 } }
Untuk menyelesaikan permintaan di Penjelajah API, Anda perlu menetapkan nilai untuk properti
id
,snippet.playlistId
, dansnippet.resourceId.videoId
.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.update? part=snippet
- Setel properti
Menghapus item playlist
Contoh ini akan menghapus video dari playlist. Permintaan ini harus diotorisasi menggunakan OAuth 2.0. Contoh ini memiliki tiga langkah. Dua langkah pertama sama dengan yang ada di contoh di atas untuk memperbarui item playlist.
Setelah menyelesaikan langkah-langkah tersebut, panggil metode playlistItems.delete
untuk menghapus video dari playlist. Setel parameter id
permintaan ke ID item playlist untuk item yang ingin Anda hapus. Permintaan ini harus diotorisasi menggunakan OAuth 2.0.
Perlu diperhatikan bahwa ID item playlist yang digunakan untuk mengidentifikasi video dalam playlist berbeda dengan ID video YouTube yang mengidentifikasi video secara unik. ID item playlist mengidentifikasi video sebagai item dalam playlist tertentu.
Untuk menyelesaikan permintaan di Penjelajah API, Anda perlu menetapkan nilai properti id
.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.delete? id=PLAYLIST_ITEM_ID
Menghapus playlist
Contoh ini akan menghapus playlist. Contoh ini memiliki dua langkah:
-
Langkah 1: Ambil ID playlist
Panggil metode
playlist.list
untuk mengambil playlist di saluran pengguna yang saat ini diautentikasi. Contoh permintaan di atas untuk mengambil playlist pengguna saat ini menunjukkan permintaan ini. Aplikasi yang memanggil API ini dapat memproses respons API untuk menampilkan daftar playlist, menggunakan setiap ID playlist sebagai kunci. -
Langkah 2: Menghapus playlist
Panggil metode
playlists.delete
untuk menghapus playlist tertentu. Dalam permintaan tersebut, parameterid
menentukan ID playlist dari playlist yang dihapus. Metode ini memerlukan token otorisasi OAuth 2.0 yang valid. Jika menguji kueri ini di Penjelajah API, Anda harus mengganti nilai parameterid
dengan ID playlist yang valid.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlists.delete? id=PLAYLIST_ID
Catatan: Jika menguji kueri ini di Penjelajah API, Anda harus mengganti nilai parameter
id
dengan ID playlist yang valid. Untuk mendapatkan ID playlist, sebaiknya jalankan permintaan yang ditampilkan di atas untuk menambahkan playlist terlebih dahulu. Ekstrak ID playlist dari respons API dan gunakan nilai tersebut untuk playlist yang ingin Anda hapus.