MembershipsLevels: list

Remarque : Ce point de terminaison ne peut être utilisé que par des créateurs individuels pour envoyer des requêtes concernant leur propre chaîne YouTube pour laquelle les souscriptions sont activées.

Liste les niveaux de souscription pour la chaîne qui a autorisé la requête. Les niveaux sont renvoyés dans l'ordre d'affichage implicite. Les requêtes API adressées à cette méthode génèrent l'une des réponses suivantes :

  • Si le créateur a activé les souscriptions à sa chaîne et défini des niveaux de prix, la réponse de l'API contient la liste des niveaux.
  • Si le créateur a activé les souscriptions à sa chaîne, mais n'a pas défini de niveaux de prix, la réponse de l'API contient une liste vide.
  • Si le créateur n'a pas activé les souscriptions à sa chaîne, l'API renvoie une channelMembershipsNotEnabled erreur.

Impact sur le quota : un appel à cette méthode a un coût de quota de 1 unité.

Requête

Requête HTTP

GET https://www.googleapis.com/youtube/v3/membershipsLevels

Cette requête requiert une autorisation ayant la portée suivante :

Champ d'application
https://www.googleapis.com/auth/youtube.channel-memberships.creator

Paramètres

Le tableau suivant répertorie les paramètres acceptés par cette requête. Tous les paramètres listés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
part string
Le paramètre part spécifie les propriétés de la ressource membershipsLevel que la réponse de l'API inclura. La valeur du paramètre est une liste de parties de ressource séparées par une virgule. La liste suivante présente les parties qui peuvent être récupérées:
  • id
  • snippet

Corps de la requête

Ne fournissez pas de corps de requête lorsque vous appelez cette méthode.

Réponse

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

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

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource :

Propriétés
kind string
Identifie le type de ressource de l'API. La valeur sera youtube#membershipsLevelListResponse.
etag etag
L'Etag de cette ressource.
items[] list
Liste des ressources membershipsLevel appartenant à la chaîne qui a autorisé la requête API.

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API peut renvoyer en réponse à un appel à cette méthode. Pour en savoir plus, consultez la documentation sur les messages d'erreur.

Type d'erreur Détails de l'erreur Description
badRequest (400) channelMembershipsNotEnabled Les souscriptions à la chaîne du créateur qui autorise la requête ne sont pas activées.