FanFundingEvents

Uwaga: to jest tylko komunikat o wycofaniu.

Funkcja finansowania przez fanów została wycofana, a interfejs API finansowania przez fanów zostanie wyłączony 28 lutego 2017 r. To ogłoszenie o wycofaniu zbiegnie się z wprowadzeniem nowej funkcji Superczatu w YouTube.

Zasób fanFundingEvent reprezentuje zdarzenie finansowania przez fanów na kanale YouTube. Finansowanie przez fanów to sposób na zarabianie pieniędzy dla twórców YouTube. Zdarzenie finansowania przez fanów ma miejsce, gdy użytkownik dokona jednorazowej, dobrowolnej wpłaty na rzecz kanału. Więcej informacji o finansowaniu przez fanów znajdziesz w Centrum pomocy YouTube.

Metody

Interfejs API obsługuje następujące metody w przypadku zasobów fanFundingEvents:

list
Wyświetla listę zdarzeń finansowania przez fanów na kanale. Żądanie do interfejsu API musi zostać autoryzowane przez właściciela kanału. Wypróbuj teraz

Reprezentowanie zasobów

Poniższa struktura JSON pokazuje format zasobu fanFundingEvents:

{
  "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
  }
}

Usługi

Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:

Usługi
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#fanFundingEvent.
etag etag
Otagowanie tego zasobu.
id string
Identyfikator przypisywany w YouTube do identyfikowania wydarzenia finansowania przez fanów.
snippet object
Obiekt snippet zawiera informacje o zdarzeniu finansowania przez fanów.
snippet.channelId string
Identyfikator kanału, który otrzymał środki.
snippet.supporterDetails object
Szczegóły dotyczące kanału wspierającego. Ten obiekt ma zastosowanie tylko wtedy, gdy osoba wspierająca udostępniła zdarzenie publiczne.
snippet.supporterDetails.channelId string
Identyfikator kanału YouTube wspierającego.
snippet.supporterDetails.channelUrl string
Adres URL kanału wspierającego.
snippet.supporterDetails.displayName string
Wyświetlana nazwa kanału wspierającego.
snippet.supporterDetails.profileImageUrl string
Adres URL awatara kanału wspierającego
snippet.commentText string
Treść tekstu komentarza wspierającego.
snippet.createdAt datetime
Data i godzina otrzymania środków. Wartość ma format ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.amountMicros unsigned long
Kwota wpłacona na konto zdarzenia finansowania. Wartość jest wyrażona w wartości mikro w walucie finansowania. Jeśli na przykład darczyńca przekazał 1 zł (wartość 1 zł), wartość snippet.amountMicros wynosi 1000000.
snippet.currency string
Waluta powiązana z kwotą finansowania. Wartością jest kod waluty w formacie ISO 4217.
snippet.displayString string
Ciąg tekstowy przeznaczony do wyświetlania, który pokazuje kwotę i walutę funduszu. Jeśli w żądaniu fanFundingEvents.list określono język aplikacji z parametrem hl, wyświetlany ciąg znaków będzie wyświetlany w tym języku. Na przykład angielska waluta będzie wyświetlana jako $1.50, ale w języku francuskim będzie wyświetlana jako 1,50$.