Halaman ini diterjemahkan oleh Cloud Translation API.

Implementasi: Playlist

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 adalah GoogleDevelopers.) Di respons API, properti id 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 parameter channelId 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 resource playlist karena properti snippet.title diperlukan saat memanggil metode ini. Selain itu, jika resource playlist yang diperbarui menentukan nilai untuk properti snippet.description atau snippet.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 resource playlistItem 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 nilai youtube#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 dan snippet.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 parameter playlistId 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 parameter part ke snippet. Isi permintaan harus berupa resource playlistItem 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 ke youtube#video.
- Setel properti snippet.resourceId.videoId ke ID video yang secara unik mengidentifikasi video yang disertakan dalam playlist.
- Tetapkan properti snippet.position ke 0 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, dan snippet.resourceId.videoId.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.update?
        part=snippet
```

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, parameter id 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 parameter id 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.