MembershipsLevels: list

Not: Bu uç nokta yalnızca bireysel içerik üreticiler tarafından kendi, kanal üyeliklerinin etkinleştirildiği YouTube kanalları için istekte bulunmak üzere kullanılabilir.

İsteği yetkilendiren kanalın üyelik seviyelerini listeler. Seviyeler, örtülü görüntüleme sırasına göre döndürülür. Bu yönteme yapılan API istekleri aşağıdaki yanıtlardan birini verir:

  • İçerik üretici, kanal üyeliklerini etkinleştirmişse ve fiyatlandırma seviyeleri varsa API yanıtında seviyelerin listesi yer alır.
  • İçerik üretici, kanal üyeliklerini etkinleştirdiyse ancak fiyatlandırma seviyelerini tanımlamadıysa API yanıtı boş bir liste içerir.
  • İçerik üretici, kanal üyeliklerini etkinleştirmediyse API channelMembershipsNotEnabled hatası döndürür.

Kota etkisi: Bu yönteme yapılan bir çağrının kota maliyeti 1 birimdir.

İstek

HTTP isteği

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

Bu istek için aşağıdaki kapsamda yetkilendirme gerekir:

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

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
Gerekli parametreler
part string
part parametresi, API yanıtının içereceği membershipsLevel kaynak özelliklerini belirtir. Parametre değeri, virgülle ayrılmış kaynak bölümleri listesidir. Aşağıdaki listede, alınabilecek parçalar gösterilmektedir:
  • id
  • snippet

İstek metni

Bu yöntemi çağırırken istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

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

Özellikler

Aşağıdaki tabloda, bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
kind string
API kaynağının türünü tanımlar. Değer youtube#membershipsLevelListResponse olur.
etag etag
Bu kaynağın ETag'i.
items[] list
API isteğini yetkilendiren kanala ait membershipsLevel kaynakların listesi.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için lütfen hata mesajı belgelerine bakın.

Hata türü Hata ayrıntısı Açıklama
badRequest (400) channelMembershipsNotEnabled İsteği yetkilendiren içerik üretici kanalında kanal üyelikleri etkinleştirilmemiştir.