MembershipsLevels: list

Nota: questo endpoint può essere utilizzato solo da singoli creator per effettuare richieste relative al proprio canale YouTube abilitato agli abbonamenti al canale. Rivolgiti al 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 generano una delle seguenti risposte:

  • Se il creator ha attivato gli abbonamenti al canale e ha livelli di prezzo, la risposta dell'API conterrà l'elenco dei livelli.
  • Se il creator ha attivato gli abbonamenti al canale, ma non ha definito livelli di prezzo, la risposta dell'API contiene 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à.

Risorse richieste:

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

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 proprietà della risorsa membershipsLevel incluse nella risposta dell'API. Il valore del parametro è un elenco di parti delle risorse separato da virgole. Il seguente elenco mostra le parti che possono essere recuperate:
  • id
  • snippet

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#membershipsLevelListResponse",
  "etag": etag,
  "items": [
    membershipsLevel 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#membershipsLevelListResponse.
etag etag
L'Etag di questa risorsa.
items[] list
Un elenco di membershipsLevel risorse 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 maggiori dettagli, consulta la documentazione sui messaggi di errore.

Tipo di errore Dettagli errore Descrizione
badRequest (400) channelMembershipsNotEnabled Sul canale del creator che autorizza la richiesta non sono abilitati gli abbonamenti al canale.