MembershipsLevels: list

Nota: questo endpoint può essere utilizzato solo dai singoli creator per effettuare richieste per il proprio canale YouTube in cui sono abilitati gli abbonamenti al canale. Contatta il tuo rappresentante di Google o YouTube per richiedere l'accesso.

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:
  • id
  • snippet

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.