MembershipsLevels: list

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

Mencantumkan level langganan untuk channel yang memberikan otorisasi 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 akan 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 sebesar 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. Parameter value adalah daftar bagian resource yang dipisahkan koma. Daftar berikut menunjukkan bagian yang dapat diambil:
  • id
  • snippet

Isi permintaan

Jangan berikan isi permintaan saat memanggil metode ini.

Respons

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

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

Properti

Tabel berikut mendefinisikan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya akan berupa youtube#membershipsLevelListResponse.
etag etag
Etag resource ini.
items[] list
Daftar membershipsLevel resource yang dimiliki oleh channel 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 detail selengkapnya.

Jenis error Detail error Deskripsi
badRequest (400) channelMembershipsNotEnabled Langganan channel tidak diaktifkan oleh channel kreator yang memberi otorisasi permintaan ini.