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.
Elenca gli eventi relativi ai finanziamenti dei fan per un canale. La richiesta API deve essere autorizzata dal proprietario del canale.
Risorse richieste:
Richiesta HTTP
GET https://www.googleapis.com/youtube/v3/fanFundingEvents
Autorizzazione
Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti (scopri di più su autenticazione e autorizzazione).
Ambito |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
https://www.googleapis.com/auth/youtube.readonly |
Parametri
Nella tabella seguente sono elencati i parametri supportati dalla query. Tutti i parametri elencati sono parametri di ricerca.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
part |
string Il parametro part specifica le parti della risorsa fanFundingEvent che verranno incluse nella risposta dell'API. I valori supportati sono id e snippet . |
|
Parametri facoltativi | ||
hl |
string Il parametro hl indica all'API di recuperare una stringa di visualizzazione della valuta localizzata per una specifica lingua dell'applicazione supportata dal sito web di YouTube. Ad esempio, in inglese la valuta viene mostrata come $1.50 , mentre in francese viene indicata come 1,50$ .Il valore del parametro deve essere un codice lingua incluso nell'elenco restituito dal metodo i18nLanguages.list . |
|
maxResults |
unsigned integer Il parametro maxResults specifica il numero massimo di elementi che devono essere restituiti nel set di risultati. I valori accettabili sono compresi tra 0 e 50 compresi. Il valore predefinito è 5 . |
|
pageToken |
string Il parametro pageToken identifica la pagina specifica nel set di risultati che il server API deve restituire. In una risposta API, la proprietà nextPageToken identifica la pagina successiva dei risultati della richiesta. |
Corpo della richiesta
Non fornire un corpo della richiesta quando chiami questo metodo.
Risposta
In caso di esito positivo, questo metodo restituisce un corpo di risposta con la seguente struttura:
{ "kind": "youtube#fanFundingEventListResponse", "etag": etag, "nextPageToken": string, "pageInfo": { "totalResults": integer, "resultsPerPage": integer }, "items": [ fanFundingEvent resource ] }
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#fanFundingEventListResponse . |
etag |
etag L'Etag di questa risorsa. |
nextPageToken |
string Il token che può essere utilizzato come valore del parametro pageToken per recuperare la pagina successiva nel set di risultati. |
pageInfo |
object L'oggetto pageInfo incapsula le informazioni sul paging per il set di risultati. |
pageInfo.totalResults |
integer Il numero totale di risultati nel set di risultati. |
pageInfo.resultsPerPage |
integer Il numero di risultati inclusi nella risposta dell'API. |
items[] |
list Un elenco di eventi relativi ai finanziamenti dei fan che corrispondono ai criteri della richiesta. |
Errori
La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per maggiori dettagli, consulta la documentazione sui messaggi di errore.
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
forbidden (403) |
insufficientPermissions |
Non disponi delle autorizzazioni necessarie per visualizzare gli eventi di Finanziamenti dei fan del canale. |
invalidValue (400) |
fanFundingNotEnabledForChannelId |
Il canale non ha attivato i finanziamenti dei fan. |
Prova.
Utilizza Explorer API per richiamare questo metodo sui dati in tempo reale e visualizzare la richiesta e la risposta dell'API.