MembershipsLevels: list

Catatan: Endpoint ini hanya dapat digunakan oleh masing-masing kreator untuk mengajukan permintaan untuk channel YouTube mereka sendiri yang mendukung langganan. Hubungi perwakilan Google atau YouTube Anda untuk meminta akses.

Mencantumkan tingkat langganan untuk channel yang mengizinkan permintaan. Level ditampilkan dalam urutan tampilan implisit. Permintaan API ke metode ini menghasilkan salah satu respons berikut:

  • Jika kreator telah mengaktifkan langganan channel dan memiliki level harga, respons API berisi daftar level.
  • Jika kreator telah mengaktifkan langganan channel tetapi belum menentukan tingkat harga, respons API akan berisi daftar kosong.
  • Jika kreator belum mengaktifkan langganan channel, API akan menampilkan error channelMembershipsNotEnabled.

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

Permintaan

Permintaan HTTP

GET https://www.googleapis.com/youtube/v3/membershipsLevels

Permintaan ini memerlukan otorisasi dengan cakupan berikut:

Cakupan
https://www.googleapis.com/auth/youtube.channel-memberships.creator

Parameter

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

Parameter
Parameter yang diperlukan
part string
Parameter part menentukan properti resource membershipsLevel yang akan disertakan dalam respons API. Nilai parameter adalah daftar bagian resource yang dipisahkan koma. Daftar berikut menunjukkan bagian-bagian yang dapat diambil:
  • id
  • snippet

Isi permintaan

Jangan berikan isi permintaan saat memanggil metode ini.

Tanggapan

Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:

{
  "kind": "youtube#membershipsLevelListResponse",
  "etag": etag,
  "items": [
    membershipsLevel Resource
  ]
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#membershipsLevelListResponse.
etag etag
Etag resource ini.
items[] list
Daftar resource membershipsLevel yang dimiliki oleh saluran yang mengizinkan permintaan API.

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) channelMembershipsNotEnabled Channel kreator yang mengizinkan permintaan ini tidak mengaktifkan langganan channel.