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$ . |