Ajoute un abonnement à la chaîne de l'utilisateur authentifié.
Impact du quota : un appel à cette méthode a un coût de quota de 50 unités.
Cas d'utilisation courants
Demande
Requête HTTP :
POST https://www.googleapis.com/youtube/v3/subscriptions
Autorisation
Une autorisation est requise pour cette requête. Celle-ci doit inclure au moins l'un des champs d'application suivants. En savoir plus sur le processus d'authentification et d'autorisation
Portée |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
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 a une double finalité. Elle identifie les propriétés que l'opération d'écriture définira, ainsi que les propriétés que la réponse de l'API inclura.La liste suivante contient les noms part que vous pouvez inclure dans la valeur du paramètre :
|
Corps de la requête
Indiquez une ressource d'abonnement dans le corps de la requête. Pour cette ressource:
-
Vous devez spécifier une valeur pour ces propriétés:
snippet.resourceId
-
Vous pouvez définir des valeurs pour les propriétés suivantes:
snippet.resourceId
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource d'abonnement dans le corps de la réponse.
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) |
subscriptionDuplicate |
L'abonnement que vous essayez de créer existe déjà. |
badRequest (400) |
subscriptionForbidden |
Vous avez atteint le nombre maximal d'abonnements. |
badRequest (400) |
subscriptionForbidden |
Vous ne pouvez pas vous abonner à votre propre chaîne. |
badRequest (400) |
subscriptionForbidden |
Trop d'abonnements récents. Veuillez réessayer dans quelques heures. |
forbidden (403) |
subscriptionForbidden |
La demande n'est pas correctement authentifiée ou n'est pas compatible avec cette chaîne. |
notFound (404) |
publisherNotFound |
La ressource spécifiée par la propriété snippet.resourceId de la requête est introuvable. |
notFound (404) |
subscriberNotFound |
L'abonné identifié avec la demande est introuvable. |
required (400) |
publisherRequired |
La ressource d'abonnement spécifiée dans la requête doit utiliser la propriété snippet.resourceId pour identifier la chaîne à laquelle vous êtes abonné. |
Essayer
Utilisez APIs Explorer pour appeler cette API et afficher la requête API et la réponse.