Subscriptions: insert

Ajoute un abonnement à la chaîne de l'utilisateur authentifié.

Impact sur le quota : un appel à cette méthode coûte 50 unités de quota.

Cas d'utilisation courants

Requête

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

Champ d'application
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
Paramètres obligatoires
part string
Le paramètre part a deux objectifs dans cette opération. Il identifie les propriétés que l'opération d'écriture définira, ainsi que celles que la réponse de l'API inclura.

La liste suivante contient les part noms que vous pouvez inclure dans la valeur de paramètre :
  • contentDetails
  • id
  • snippet
  • subscriberSnippet

Corps de la requête

Fournissez 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 ces propriétés :

    • snippet.resourceId

Réponse

Si la requête aboutit, cette méthode renvoie une ressource d'abonnement dans le corps de la réponse.

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) 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 Vous avez effectué trop d'abonnements récemment. Veuillez réessayer dans quelques heures.
forbidden (403) subscriptionForbidden La requête 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é dans la requête 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 l'utilisateur s'abonne.

Essayer

Utilisez le APIs Explorer pour appeler cette API et afficher la requête et la réponse.