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

Mise en œuvre: abonnements

Les exemples suivants montrent comment utiliser l'API YouTube Data (v3) pour exécuter des fonctions liées aux abonnements.

Récupérer les abonnements d'une chaîne

Appelez la méthode subscriptions.list pour récupérer les abonnements d'une chaîne particulière. Vous pouvez l'identifier de deux manières:

Pour récupérer les abonnements de l'utilisateur actuellement authentifié, définissez la valeur du paramètre mine sur true. Notez qu'une requête utilisant le paramètre mine doit être autorisée à l'aide d'OAuth 2.0.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mine=true
```
Pour récupérer les abonnements d'une autre chaîne, définissez la valeur du paramètre channelId sur l'ID unique de la chaîne YouTube. L'exemple ci-dessous récupère la liste des chaînes auxquelles la chaîne TED est abonnée sur YouTube.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &channelId=UCAuUUnT6oDeKwE6v1NGQxug
```
Remarque : L'API renvoie un code de réponse HTTP 403 (Forbidden) si la chaîne spécifiée n'expose pas publiquement ses abonnements et que la demande n'est pas autorisée par le propriétaire de la chaîne.

Consultez la documentation de la méthode subscriptions.list pour obtenir des exemples de code.

Ajouter un abonnement

Appelez la méthode subscriptions.insert pour ajouter un abonnement à une chaîne. Cette requête doit être autorisée à l'aide d'OAuth 2.0. Le corps de la requête est une ressource subscription qui définit les valeurs suivantes:

snippet.resourceId.kind contient la valeur youtube#channel.
La propriété snippet.resourceId.channelId identifie la chaîne à laquelle vous êtes abonné. La valeur de la propriété correspond à un ID de chaîne YouTube unique. Vous pouvez obtenir l'ID de la chaîne de différentes manières, par exemple en appelant la méthode channels.list ou en récupérant des résultats de recherche pour les chaînes.

La demande d'API ci-dessous vous permet de vous abonner à la chaîne TED sur YouTube :

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

Le corps de la requête est le suivant :

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

Consultez la documentation de la méthode subscriptions.insert pour obtenir des exemples de code.

Supprimer un abonnement

Cet exemple supprime un abonnement. Cette requête doit être autorisée à l'aide d'OAuth 2.0. Cet exemple comporte deux étapes:

Étape 1: Récupérez les abonnements de la chaîne de l'utilisateur authentifié

Appelez la méthode subscriptions.list pour récupérer la liste des abonnements. L'exemple ci-dessus pour récupérer les abonnements d'une chaîne explique comment effectuer cette demande.

L'application appelant l'API peut traiter la réponse de l'API pour afficher une liste d'abonnements, en utilisant l'ID de chaque abonnement comme clé. Dans la réponse, la propriété id de chaque élément identifie l'ID d'abonnement qui identifie de manière unique l'abonnement correspondant. Vous utiliserez cette valeur pour supprimer un article de la liste à l'étape suivante.
Étape 2: Supprimez un abonnement

Appelez la méthode subscriptions.delete pour supprimer un abonnement. Définissez le paramètre id de la requête sur l'ID de l'abonnement que vous souhaitez supprimer. Cette requête doit être autorisée à l'aide d'OAuth 2.0.

Pour terminer la requête dans APIs Explorer, vous devez définir la valeur de la propriété id.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
        id=SUBSCRIPTION_ID
```

Consultez la documentation de la méthode subscriptions.delete pour obtenir des exemples de code.

Récupérer une liste d'abonnés à la chaîne de l'utilisateur autorisé

Pour récupérer la liste des chaînes qui s'abonnent à la chaîne de l'utilisateur actuellement authentifié, appelez la méthode subscriptions.list et définissez la valeur du paramètre mySubscribers sur true. La requête doit être autorisée à l'aide d'OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true