MembershipsLevels: list

Nota: questo endpoint può essere utilizzato solo dai singoli creator per effettuare richieste per il proprio canale YouTube con abbonamenti attivati.

Elenca i livelli di abbonamento per il 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 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 contiene un elenco vuoto.
  • Se il creator non ha attivato gli abbonamenti al canale, l'API restituisce un channelMembershipsNotEnabled errore.

Impatto sulla 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 verranno incluse nella risposta dell'API. Il valore parametro è un elenco separato da virgole di parti di risorse. L'elenco seguente 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 della risposta con la seguente struttura:

{
  "kind": "youtube#membershipsLevelListResponse",
  "etag": etag,
  "items": [
    membershipsLevel Resource
  ]
}

Proprietà

La tabella seguente definisce le proprietà che appaiono 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 maggiori dettagli, consulta la documentazione sui messaggi di errore.

Tipo di errore Dettagli errore Descrizione
badRequest (400) channelMembershipsNotEnabled Il canale del creator che autorizza la richiesta non ha attivato gli abbonamenti al canale.