Subscriptions: insert

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 : contentDetails id snippet subscriberSnippet

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.