MembershipsLevels: list

Remarque: Ce point de terminaison ne peut être utilisé que par les créateurs individuels pour demander l'ajout d'une chaîne YouTube sur laquelle les souscriptions sont activées. Contactez votre représentant Google ou YouTube pour demander l'accès.

Répertorie les niveaux de souscription de la chaîne qui a autorisé la demande. Les niveaux sont renvoyés dans un 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 aux chaînes et qu'il propose différents niveaux de tarification, la réponse de l'API contient la liste des niveaux.
  • Si le créateur a activé les souscriptions aux chaînes, mais qu'il n'a pas défini les niveaux de tarification, la réponse de l'API contient une liste vide.
  • Si le créateur n'a pas activé les souscriptions aux chaînes, l'API renvoie une erreur channelMembershipsNotEnabled.

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

Demande

Requête HTTP :

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

Cette requête nécessite une autorisation dont la portée est la suivante:

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

Paramètres

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

Paramètres
Réglages obligatoires
part string
Le paramètre part spécifie les propriétés de ressources membershipsLevel qui seront incluses dans la réponse de l'API. La valeur du paramètre est une liste de parties de ressources séparées par une virgule. La liste suivante présente les éléments pouvant être récupérés:
  • 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
ETag de cette ressource.
items[] list
Liste de membershipsLevel ressources appartenant au canal qui a autorisé la requête API.

Erreurs

Le tableau suivant identifie les messages d'erreur que l'API pourrait renvoyer en réponse à un appel à cette méthode. Veuillez consulter la documentation sur les messages d'erreur pour en savoir plus.

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