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:
|
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. |