Subscriptions: insert

Menambahkan langganan untuk saluran pengguna terautentikasi.

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

Kasus penggunaan umum

Permintaan

Permintaan HTTP

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

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah 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. Parameter ini mengidentifikasi properti yang akan ditetapkan oleh operasi tulis serta properti yang akan disertakan oleh 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 berikut:

    • snippet.resourceId

Respons

Jika berhasil, metode ini akan 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 detail selengkapnya.

Jenis error Detail error Deskripsi
badRequest (400) subscriptionDuplicate Langganan yang Anda coba buat sudah ada.
badRequest (400) subscriptionForbidden Anda telah mencapai jumlah langganan maksimum.
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 channel 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 disubscribe.

Cobalah!

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