Cette page a été traduite par l'API Cloud Translation.

Subscriptions: insert

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

Impact sur les quotas:un appel à cette méthode entraîne un coût du quota de 50 unités.

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 répertoriés sont des paramètres de requête.

Paramètres
Paramètres obligatoires
`part`	`string` Le paramètre `part` a deux finalités 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 noms `part` que vous pouvez inclure dans la valeur du 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

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 peut renvoyer en réponse à un appel de 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 votre 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 requête n'est pas correctement authentifiée ou n'est pas compatible avec ce canal.
`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 requête est introuvable.
`required (400)`	`publisherRequired`	La ressource d'abonnement spécifiée dans la demande doit utiliser la propriété `snippet.resourceId` pour identifier la chaîne à laquelle l'utilisateur est abonné.

Essayer

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