FanFundingEvents

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.

fanFundingEvent kaynağı, YouTube kanalındaki bir Hayran Bağışları etkinliğini temsil eder. Hayran Bağışları, YouTube içerik üreticilerini parasal olarak desteklemenin bir yolunu sunar. Hayran Bağışları etkinliği, kullanıcı bir kez gönüllü olarak ödeme yaptığında gerçekleşir. Hayran Bağışı hakkında daha fazla bilgi edinmek için YouTube Yardım Merkezi'ne bakın.

Yöntemler

API, fanFundingEvents kaynakları için aşağıdaki yöntemleri destekler:

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

Kaynak temsili

Aşağıdaki JSON yapısı, bir fanFundingEvents kaynağının biçimini göstermektedir:

{
  "kind": "youtube#fanFundingEvent",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "supporterDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "commentText": string,
    "createdAt": datetime,
    "amountMicros": unsigned long,
    "currency": string,
    "displayString": string
  }
}

Ö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#fanFundingEvent olacak.
etag etag
Bu kaynağın Etag'i.
id string
YouTube'un takipçi bağışları etkinliğini benzersiz bir şekilde tanımlamak için atadığı kimlik.
snippet object
snippet nesnesi, hayran bağışı etkinliğiyle ilgili bilgileri içeriyor.
snippet.channelId string
Fonu alan kanalın kimliği.
snippet.supporterDetails object
Destekçinin kanalıyla ilgili ayrıntılar. Bu nesne yalnızca destekçinin finansman etkinliğini herkese açık hâle getirmesi durumunda mevcuttur.
snippet.supporterDetails.channelId string
Destekçinin YouTube kanal kimliği.
snippet.supporterDetails.channelUrl string
Destekçinin kanalının URL'si.
snippet.supporterDetails.displayName string
Destekçinin kanalının adı.
snippet.supporterDetails.profileImageUrl string
Destekçinin kanalının avatar URL'si.
snippet.commentText string
Destekçinin yorumunun metin içeriği.
snippet.createdAt datetime
Ödemenin yapıldığı tarih ve saat. Değer ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) biçiminde belirtilir.
snippet.amountMicros unsigned long
Fon sağlama etkinliğine katkıda bulunulan para tutarı. Değer, finanse edilen paranın mikro cinsinden değeridir. Örneğin, fon sahibi bir dolar (1 ABD doları) sağlamışsa snippet.amountMicros mülk değeri 1000000 olur.
snippet.currency string
Fonlama tutarıyla ilişkili para birimi. Değer bir ISO 4217 para birimi kodudur.
snippet.displayString string
Fon sağlamak için gerekli tutarı ve para birimini gösteren, görüntüleme amaçlı bir dize. fanFundingEvents.list isteği, hl parametresiyle bir uygulama dili belirtiyorsa görüntüleme dizesi bu dilde görüntülenecek şekilde yerelleştirilir. Örneğin, İngilizce olarak para birimi $1.50, Fransızca dilinde 1,50$ olarak gösterilir.