FanFundingEvents: list

Not: Bu bir kullanımdan kaldırma duyurusudur.

Takipçi Bağışları özelliği kullanımdan kaldırıldı ve 28 Şubat 2017'de Takipçi Bağışları API'si devre dışı bırakılacak. Kullanımdan kaldırma duyurusu, YouTube'un yeni Super Chat özelliğinin kullanıma sunulmasıyla aynı zamanda gerçekleşecektir.

Bir kanalın takipçi bağışları etkinliklerini listeler. API isteği, kanal sahibi tarafından yetkilendirilmelidir.

İstek

HTTP isteği

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

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az birinin yetkilendirilmesi gerekir (kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinin).

Kapsam
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

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 fanFundingEvent kaynak bölümlerini belirtir. id ve snippet değerleri desteklenir.
İsteğe bağlı parametreler
hl string
hl parametresi, API'ye YouTube web sitesinin desteklediği belirli bir uygulama dili için yerelleştirilmiş bir para birimi görüntüleme dizesi almasını bildirir. Örneğin, İngilizce olarak para birimi $1.50, Fransızca dilinde 1,50$ olarak gösterilir.

Parametre değeri, i18nLanguages.list yöntemi tarafından döndürülen listeye dahil edilen bir dil kodu olmalıdır.
maxResults unsigned integer
maxResults parametresi, sonuç grubunda döndürülmesi gereken maksimum öğe sayısını belirtir. Kabul edilebilir değerler 0 ile 50 arasındadır (bu değerler dahil). Varsayılan değer: 5
pageToken string
pageToken parametresi, sonuç kümesinde API sunucusundan döndürülmesi istenen sayfayı tanımlar. Bir API yanıtında, nextPageToken özelliği istek için sonraki sonuç sayfasını tanımlar.

İ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#fanFundingEventListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    fanFundingEvent 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#fanFundingEventListResponse olacak.
etag etag
Bu kaynağın Etag'i.
nextPageToken string
Sonuç kümesinde sonraki sayfayı almak için pageToken parametresinin değeri olarak kullanılabilecek jeton.
pageInfo object
pageInfo nesnesi, sonuç grubunun sayfa oluşturma bilgilerini içerir.
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 takipçi bağışı etkinliklerinin 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
forbidden (403) insufficientPermissions Kanalın Takipçi Bağışları etkinliklerini görüntülemek için gerekli izinlere sahip değilsiniz.
invalidValue (400) fanFundingNotEnabledForChannelId Kanalda Hayran Bağışları etkinleştirilmemiştir.

Deneyin.

Bu yöntemi canlı verilerde çağırmak ve API isteğini ve yanıtını görmek için API Gezgini'ni kullanın.