Subscriptions: insert

Menambahkan langganan untuk saluran pengguna terautentikasi.

Dampak kuota: Panggilan ke metode ini memiliki biaya kuota 50 unit.

Kasus penggunaan umum

Permintaan

Permintaan HTTP

POST https://www.googleapis.com/youtube/v3/subscriptions

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).

Cakupan
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parameter

Tabel berikut mencantumkan parameter yang didukung kueri ini. Semua parameter yang tercantum adalah parameter kueri.

Parameter
Parameter yang diperlukan
part string
Parameter part memiliki dua tujuan dalam operasi ini. Tag tersebut mengidentifikasi properti yang akan ditetapkan oleh operasi tulis serta properti yang akan disertakan dalam respons API.

Daftar berikut berisi nama part yang dapat Anda sertakan dalam nilai parameter:
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

Isi permintaan

Berikan resource langganan dalam isi permintaan. Untuk resource tersebut:

  • Anda harus menentukan nilai untuk properti ini:

    • snippet.resourceId

  • Anda dapat menetapkan nilai untuk properti ini:

    • snippet.resourceId

Tanggapan

Jika berhasil, metode ini menampilkan resource langganan dalam isi respons.

Error

Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan ke metode ini. Lihat dokumentasi pesan error untuk mengetahui detail selengkapnya.

Jenis error Detail error Deskripsi
badRequest (400) subscriptionDuplicate Langganan yang Anda coba buat sudah ada.
badRequest (400) subscriptionForbidden Anda telah mencapai jumlah maksimum langganan.
badRequest (400) subscriptionForbidden Subscribe ke channel Anda sendiri tidak didukung.
badRequest (400) subscriptionForbidden Terlalu banyak langganan terbaru. Coba lagi dalam beberapa jam.
forbidden (403) subscriptionForbidden Permintaan tidak diautentikasi dengan benar atau tidak didukung untuk saluran ini.
notFound (404) publisherNotFound Resource yang ditentukan oleh properti snippet.resourceId permintaan tidak dapat ditemukan.
notFound (404) subscriberNotFound Pelanggan yang diidentifikasi dengan permintaan tidak dapat ditemukan.
required (400) publisherRequired Resource subscription yang ditentukan dalam permintaan harus menggunakan properti snippet.resourceId untuk mengidentifikasi channel yang di-subscribe.

Cobalah!

Gunakan APIs Explorer untuk memanggil API ini dan melihat permintaan dan respons API.