FanFundingEvents

Hinweis: Dies ist eine Einstellungsankündigung.

Die Funktion "Finanzierung durch Fans" wurde eingestellt und die Finanzierung durch Fans wird am 28. Februar 2017 deaktiviert. Diese Ankündigung wird mit der Veröffentlichung der neuen YouTube-Funktion Super Chat zusammengetragen.

Eine Ressource vom Typ fanFundingEvent steht für ein Ereignis zur Finanzierung durch Fans in einem YouTube-Kanal. Die Finanzierung durch Fans bietet eine Möglichkeit, YouTube-Creator finanziell zu unterstützen. Ein Ereignis zur Finanzierung durch Fans findet statt, wenn ein Nutzer eine einmalige, freiwillige Zahlung an einen Kanal ausführt. Weitere Informationen zur Finanzierung durch Fans findest du in der YouTube-Hilfe.

Methoden

Die API unterstützt die folgenden Methoden für fanFundingEvents-Ressourcen:

list
Listet Veranstaltungen zur Finanzierung durch Fans für einen Kanal auf. Die API-Anfrage muss vom Kanalinhaber autorisiert werden. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer fanFundingEvents-Ressource:

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

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:

Attribute
kind string
Identifiziert den Typ der API-Ressource. Der Wert ist youtube#fanFundingEvent.
etag etag
Das ETag dieser Ressource.
id string
Die ID, die YouTube zur eindeutigen Identifizierung der Finanzierung durch Fans zuweist.
snippet object
Das snippet-Objekt enthält Informationen über die Finanzierung durch Fans.
snippet.channelId string
Die ID des Kanals, der die Zahlung erhalten hat.
snippet.supporterDetails object
Details zum Kanal des Unterstützers Dieses Objekt ist nur vorhanden, wenn der Unterstützer das Finanzierungsereignis veröffentlicht hat.
snippet.supporterDetails.channelId string
Die YouTube-Kanal-ID des Unterstützers.
snippet.supporterDetails.channelUrl string
Die URL des Unterstützer-Kanals
snippet.supporterDetails.displayName string
Der Anzeigename des Kanals der Unterstützer.
snippet.supporterDetails.profileImageUrl string
Die Avatar-URL für den Kanal des Unterstützers
snippet.commentText string
Der Text des Kommentars des Unterstützers.
snippet.createdAt datetime
Datum und Uhrzeit der Finanzierung. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
snippet.amountMicros unsigned long
Der Geldbetrag, der bei der Finanzierung beigetragen hat. Der Wert wird in „micros“ (micros) der Währung des Betrags angegeben. Wenn der Geldgeber beispielsweise einen Dollar (1 €) beigetragen hat, lautet der snippet.amountMicros-Property-Wert 1000000.
snippet.currency string
Die Währung für den Zahlungsbetrag Der Wert ist ein ISO 4217-Währungscode.
snippet.displayString string
Ein String, der für das Displaynetzwerk vorgesehen ist und den Betrag und die Währung des Fonds angibt. Wenn in der fanFundingEvents.list-Anfrage eine Anwendungssprache mit dem Parameter hl angegeben wurde, wird der Anzeigestring für die Anzeige in dieser Sprache lokalisiert. Beim Englischen wäre die Währung $1.50, auf Französisch hingegen 1,50$.