Elenca i livelli di abbonamento del canale che ha autorizzato la richiesta. I livelli vengono restituiti in ordine di visualizzazione implicito. Le richieste API a questo metodo restituiscono una delle seguenti risposte:
- Se il creator ha attivato gli abbonamenti al canale e prevede livelli di prezzo, la risposta dell'API contiene l'elenco dei livelli.
- Se il creator ha attivato gli abbonamenti al canale, ma non ha definito i livelli di prezzo, la risposta dell'API conterrà un elenco vuoto.
- Se il creator non ha attivato gli abbonamenti al canale, l'API restituisce un
errore
channelMembershipsNotEnabled
.
Impatto della quota: una chiamata a questo metodo ha un costo della quota di 1 unità.
Richiesta
Richiesta HTTP
GET https://www.googleapis.com/youtube/v3/membershipsLevels
Questa richiesta richiede l'autorizzazione con il seguente ambito:
Ambito |
---|
https://www.googleapis.com/auth/youtube.channel-memberships.creator |
Parametri
La tabella seguente elenca i parametri supportati da questa query. Tutti i parametri elencati sono parametri di query.
Parametri | ||
---|---|---|
Parametri obbligatori | ||
part |
string Il parametro part specifica le proprietà della risorsa membershipsLevel
che saranno incluse nella risposta dell'API. Il valore del parametro è un elenco separato da virgole di parti di risorse. Il seguente elenco mostra le parti che possono
essere recuperate:
|
Corpo della richiesta
Non fornire il corpo della richiesta quando chiami questo metodo.
Risposta
Se l'esito è positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:
{ "kind": "youtube#membershipsLevelListResponse", "etag": etag, "items": [ membershipsLevel Resource ] }
Proprietà
La tabella seguente definisce le proprietà visualizzate in questa risorsa:
Proprietà | |
---|---|
kind |
string Identifica il tipo di risorsa API. Il valore sarà youtube#membershipsLevelListResponse . |
etag |
etag L'Etag di questa risorsa. |
items[] |
list Un elenco di risorse membershipsLevel di proprietà del canale che ha autorizzato la richiesta API. |
Errori
La tabella seguente identifica i messaggi di errore che l'API potrebbe restituire in risposta a una chiamata a questo metodo. Per ulteriori dettagli, consulta la documentazione relativa ai messaggi di errore.
Tipo di errore | Dettagli errore | Descrizione |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
Gli abbonamenti al canale non sono attivi per il canale del creator che autorizza la richiesta. |