Members: list

Not: Bu uç nokta, yalnızca bireysel içerik üreticiler tarafından kendi kanal üyelikleri etkinleştirilmiş YouTube kanalları için istekte bulunmak amacıyla kullanılabilir. Erişim isteğinde bulunmak için Google veya YouTube temsilcinizle iletişime geçin.

Bir kanalın üyelerini (eski adıyla "sponsorlar") listeler. API isteği, kanal sahibi tarafından yetkilendirilmelidir.

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

İstek

HTTP isteği

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

Yetkilendirme

Bu istek, aşağıdaki kapsamda yetkilendirme gerektirir:

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 member kaynak özelliklerini belirtir. Parametre değerini snippet olarak ayarlayın.
İsteğe bağlı parametreler
mode string
mode parametresi, API yanıtına hangi üyelerin dahil edileceğini belirtir. Parametre değerini aşağıdaki değerlerden birine ayarlayın:
  • all_current (varsayılan) - Mevcut üyeleri en yeni üyeden en eski üyeye doğru listeleyin. Bu değer kullanıldığında, API yanıtı nextPageToken içermiyorsa listenin sonuna ulaşılır.
  • updates: Yalnızca önceki API çağrısından sonra katılan veya yükseltme yapan üyeleri listeler. İlk çağrının yeni bir güncelleme akışı başlattığını ancak aslında herhangi bir üye döndürmediğini unutmayın. Üyelik güncellemelerini almaya başlamak için istediğiniz sıklıkta nextPageToken kullanarak uç noktayı yoklamanız gerekir.

    Bu değer kullanıldığında API yanıtının her zaman bir nextPageToken içerdiğini unutmayın.
maxResults unsigned integer
maxResults parametresi, sonuç kümesinde döndürülmesi gereken maksimum öğe sayısını belirtir. Kabul edilen değerler, 0 ile 1000 (bu değerler dahil) arasındadır. Varsayılan değer: 5.
pageToken string
pageToken parametresi, sonuç kümesinde döndürülmesi gereken belirli bir sayfayı tanımlar. Jeton, orijinal API isteğiyle kullanılan mode için geçerlidir. Bu nedenle, bir modla alınan sayfa jetonunu daha sonra farklı bir moda geçmek için kullanamazsınız.
hasAccessToLevel string
hasAccessToLevel parametre değeri, sonuç kümesindeki üyelerin sahip olması gereken minimum seviyeyi belirten bir seviye kimliğidir.
filterByMemberChannelId string
filterByMemberChannelId parametresi, belirli kullanıcıların üyelik durumunu kontrol etmek için kullanılabilecek, virgülle ayrılmış kanal kimlikleri listesini belirtir. Örneğin, UC_1,UC_2,UC_3. Çağrı başına en fazla 100 kanal belirtilebilir.

İ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#memberListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    member 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#memberListResponse olur.
etag etag
Bu kaynağın ETag'i.
nextPageToken string
Sonuç kümesindeki sonraki sayfayı almak için pageToken parametresinin değeri olarak kullanılabilecek jeton. Sayfa jetonlarının süresi dolabilir. Bu durumda uygulamanız jetonu bırakmalı ve yeni bir istek başlatmak için API'yi pageToken olmadan çağırmalıdır.
pageInfo object
pageInfo nesnesi, sonuç kümesi için sayfalama bilgilerini kapsar.
pageInfo.totalResults integer
Sonuç kümesindeki toplam sonuç sayısı.
pageInfo.resultsPerPage integer
API yanıtına dahil edilen sonuçların sayısı.
items[] list
İstek ölçütleriyle eşleşen üyelerin 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ı belirtilmektedir. 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ş.
badRequest (400) invalidMode mode parametre değeri geçersiz. Bu hata, pageToken parametresi belirtilenden farklı bir mod kullanılarak alınan bir jeton belirtiyorsa ortaya çıkabilir.
badRequest (400) invalidPageToken pageToken parametre değeri geçersiz. Bu hata, istekte kullanılan sayfa jetonunun süresi dolmuşsa veya jeton tanınmıyorsa ortaya çıkabilir.
badRequest (400) invalidHasAccessToLevel hasAccessToLevel parametre değeri geçersiz. Belirtilen id ile eşleşen bir seviye yok.
badRequest (400) invalidFilterByMemberChannelId filterByMemberChannelId parametre değeri geçersiz. Bu hata, filterByMemberChannelId parametre değeri 100'den fazla kanal belirtiyorsa meydana gelir.