İsteği yetkilendiren kanalın üyelik seviyelerini listeler. Seviyeler, dolaylı görüntüleme sırasına göre döndürülür. Bu yönteme yönelik API istekleri aşağıdaki yanıtlardan birini sağlar:
- İçerik üretici kanal üyeliklerini etkinleştirdiyse ve fiyatlandırma düzeylerine sahipse API yanıtı, seviyelerin listesini içerir.
- İçerik üretici kanal üyeliklerini etkinleştirdiyse ancak fiyatlandırma seviyeleri tanımlamadıysa API yanıtı boş bir liste içerir.
- İçerik üretici kanal üyeliklerini etkinleştirmediyse API,
channelMembershipsNotEnabled
hatası verir.
Kota etkisi: Bu yönteme yapılan bir aramanın kota maliyeti 1 birimdir.
İstek
HTTP isteği
GET https://www.googleapis.com/youtube/v3/membershipsLevels
Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:
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, kaynak parçalarının virgülle ayrılmış listesidir. Alınabilecek parçalar aşağıdaki listede gösterilmektedir:
|
İstek metni
Bu yöntemi çağırırken bir 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 olacak. |
etag |
etag Bu kaynağın Etag'i. |
items[] |
list API isteğini yetkilendiren kanalın sahip olduğu membershipsLevel kaynakların listesi. |
Hatalar
Aşağıdaki tabloda, API'nin bu yönteme yapılan çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla ayrıntı için lütfen hata mesajı dokümanlarını inceleyin.
Hata türü | Hata ayrıntısı | Açıklama |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
İsteği yetkilendiren içerik üretici kanalında kanal üyelikleri etkinleştirilmemiş. |