FanFundingEvents

Nota: questo è un annuncio di ritiro.

La funzionalità Finanziamenti dei fan è stata ritirata e l'API Finanziamenti dei fan verrà disattivata il 28 febbraio 2017. Questo annuncio verrà ritirato con il lancio della nuova funzionalità Superchat di YouTube.

Una risorsa fanFundingEvent rappresenta un evento per i finanziamenti dei fan su un canale YouTube. I finanziamenti dei fan rappresentano un modo per sostenere economicamente i creator di YouTube. Un evento Finanziamenti dei fan si verifica quando un utente effettua un pagamento una tantum a un canale. Per scoprire di più su Finanziamenti dei fan, consulta il Centro assistenza YouTube.

Metodi

L'API supporta i seguenti metodi per le risorse di fanFundingEvents:

list
Elenca gli eventi relativi ai finanziamenti dei fan di un canale. La richiesta API deve essere autorizzata dal proprietario del canale. Prova subito.

Rappresentazione delle risorse

La seguente struttura JSON mostra il formato di una risorsa 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
  }
}

Proprietà

La tabella seguente definisce le proprietà che vengono visualizzate in questa risorsa:

Proprietà
kind string
Identifica il tipo di risorsa API. Il valore sarà youtube#fanFundingEvent.
etag etag
L'Etag di questa risorsa.
id string
L'ID assegnato da YouTube per identificare in modo univoco l'evento relativo ai finanziamenti dei fan.
snippet object
L'oggetto snippet contiene informazioni sull'evento relativo ai finanziamenti dei fan.
snippet.channelId string
L'ID del canale che ha ricevuto il finanziamento.
snippet.supporterDetails object
Dettagli sul canale del sostenitori. Questo oggetto è presente solo se il sostenitori ha reso pubblico l'evento di finanziamento.
snippet.supporterDetails.channelId string
L'ID del canale YouTube del sostenitori.
snippet.supporterDetails.channelUrl string
L'URL del canale del sostenitori.
snippet.supporterDetails.displayName string
Il nome visualizzato del canale del sostenitori.
snippet.supporterDetails.profileImageUrl string
L'URL dell'avatar per il canale del sostenitori.
snippet.commentText string
I contenuti testuali del commento del sostenitori.
snippet.createdAt datetime
La data e l'ora in cui si è verificato il finanziamento. Il valore è specificato nel formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.amountMicros unsigned long
L'importo dato che è stato contribuito all'evento finanziario. Il valore è in micro della valuta di finanziamento. Ad esempio, se il finanziatore ha contribuito con un dollaro (1 $), il valore della proprietà snippet.amountMicros è 1000000.
snippet.currency string
La valuta associata all'importo del finanziamento. Il valore è un codice valuta ISO 4217.
snippet.displayString string
Una stringa, destinata alla visualizzazione, che mostra l'importo e la valuta del fondo. Se la richiesta fanFundingEvents.list ha specificato una lingua dell'applicazione con il parametro hl, la stringa di visualizzazione viene localizzata per la visualizzazione in quella lingua. Ad esempio, in inglese la valuta sarà $1.50, mentre in francese sarà 1,50$.