Halaman ini diterjemahkan oleh Cloud Translation API.

Implementasi: Langganan

Contoh berikut menunjukkan cara menggunakan YouTube Data API (v3) untuk menjalankan fungsi yang terkait dengan subscription.

Mengambil subscription channel

Panggil metode subscriptions.list untuk mengambil subscription untuk saluran tertentu. Ada dua cara untuk mengidentifikasi channel tersebut:

Untuk mengambil langganan pengguna yang saat ini diautentikasi, tetapkan 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.subscriptions.list?
        part=snippet,contentDetails
        &mine=true
```
Untuk mengambil subscription channel lain, tetapkan nilai parameter channelId ke ID channel YouTube unik channel tersebut. Contoh di bawah ini mengambil daftar channel yang disubscribe oleh channel TED di YouTube.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &channelId=UCAuUUnT6oDeKwE6v1NGQxug
```
Catatan: API akan menampilkan kode respons HTTP 403 (Forbidden) jika saluran yang ditentukan tidak mengekspos langganannya secara publik dan permintaan tidak diizinkan oleh pemilik saluran.

Lihat dokumentasi metode subscriptions.list untuk contoh kode.

Menambahkan langganan

Panggil metode subscriptions.insert untuk menambahkan langganan saluran. Permintaan ini harus diotorisasi menggunakan OAuth 2.0. Isi permintaan adalah resource subscription yang menetapkan nilai-nilai berikut:

snippet.resourceId.kind berisi nilai youtube#channel.
Properti snippet.resourceId.channelId mengidentifikasi channel yang disubscribe. Nilai properti adalah ID channel YouTube yang unik. ID saluran dapat diperoleh dengan beberapa cara, termasuk memanggil metode channels.list atau mengambil hasil penelusuran untuk saluran.

Permintaan API di bawah ini membuat Anda subscribe ke channel TED di YouTube:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

Isi permintaan adalah:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

Lihat dokumentasi metode subscriptions.insert untuk contoh kode.

Menghapus langganan

Contoh ini menghapus langganan. Permintaan ini harus diotorisasi menggunakan OAuth 2.0. Contoh ini memiliki dua langkah:

Langkah 1: Ambil subscription untuk channel pengguna yang diautentikasi

Panggil metode subscriptions.list untuk mengambil daftar langganan. Contoh di atas untuk mengambil subscription channel menjelaskan cara membuat permintaan ini.

Aplikasi yang memanggil API ini dapat memproses respons API untuk menampilkan daftar langganan, menggunakan setiap ID langganan sebagai kunci. Dalam respons, setiap properti id item mengidentifikasi ID langganan yang secara unik mengidentifikasi langganan yang sesuai. Anda akan menggunakan nilai tersebut untuk menghapus item dari daftar di langkah berikutnya.
Langkah 2: Hapus langganan

Panggil metode subscriptions.delete untuk menghapus langganan. Setel parameter id permintaan ke ID langganan untuk langganan yang ingin Anda hapus. Permintaan ini harus diotorisasi menggunakan OAuth 2.0.

Untuk menyelesaikan permintaan di Penjelajah API, Anda perlu menetapkan nilai properti id.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
        id=SUBSCRIPTION_ID
```

Lihat dokumentasi metode subscriptions.delete untuk contoh kode.

Mengambil daftar subscriber channel pengguna yang diberi otorisasi

Untuk mengambil daftar saluran yang berlangganan ke saluran pengguna yang saat ini diautentikasi, panggil metode subscriptions.list dan tetapkan nilai parameter mySubscribers ke true. Permintaan harus diotorisasi menggunakan OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true