Halaman ini diterjemahkan oleh Cloud Translation API.

Implementasi: Langganan

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

Mengambil subscription channel

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

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

Lihat dokumentasi metode subscriptions.list untuk contoh kode.

Menambahkan langganan

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

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

Permintaan API di bawah akan 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 langganan untuk channel pengguna yang diautentikasi

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

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

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

Untuk menyelesaikan permintaan di API Explorer, Anda harus 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 ke channel pengguna resmi

Untuk mengambil daftar channel yang berlangganan ke channel 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