Se usó la API de Cloud Translation para traducir esta página.

Implementación: Suscripciones

Los siguientes ejemplos muestran cómo utilizar la API de datos de YouTube (v3) para realizar funciones relacionadas con las suscripciones.

Recuperar las suscripciones a un canal

Llama al método subscriptions.list para recuperar las suscripciones de un canal en particular. Existen dos formas de identificar el canal:

Para recuperar las suscripciones del usuario autenticado actualmente, establece el valor del parámetro mine en true. Ten en cuenta que una solicitud que use el parámetro mine debe autorizarse mediante OAuth 2.0.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mine=true
```
Para recuperar las suscripciones de cualquier otro canal, establece el valor del parámetro channelId en el ID único del canal de YouTube. El ejemplo a continuación recupera una lista de canales a los que se suscribió el canal de TED en YouTube.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &channelId=UCAuUUnT6oDeKwE6v1NGQxug
```
Nota: Si el canal especificado no expone públicamente sus suscripciones y la solicitud no está autorizada por el propietario del canal, la API muestra un código de respuesta HTTP 403 (Forbidden).

Consulta la documentación del método subscriptions.list para ver muestras de código.

Agrega una suscripción

Llama al método subscriptions.insert para agregar una suscripción al canal. Esta solicitud debe autorizarse con OAuth 2.0. El cuerpo de la solicitud es un recurso subscription que establece los siguientes valores:

snippet.resourceId.kind contiene el valor youtube#channel.
La propiedad snippet.resourceId.channelId identifica el canal al que te estás suscribiendo. El valor de la propiedad es un ID de canal de YouTube único. El ID del canal se puede obtener de varias maneras, que incluyen la llamada al método channels.list o la recuperación de resultados de búsqueda para los canales.

La solicitud de API que aparece a continuación te suscribe al canal de TED en YouTube:

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

El cuerpo de la solicitud es el siguiente:

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

Consulta la documentación del método subscriptions.insert para ver muestras de código.

Cómo borrar una suscripción

En este ejemplo, se borra una suscripción. Esta solicitud debe autorizarse con OAuth 2.0. Este ejemplo tiene dos pasos:

Paso 1: Recupera las suscripciones del canal del usuario autenticado

Llama al método subscriptions.list para recuperar la lista de suscripciones. El ejemplo anterior para recuperar las suscripciones de un canal explica cómo realizar esta solicitud.

La aplicación que llama a la API podría procesar la respuesta de la API para mostrar una lista de suscripciones y usar el ID de cada suscripción como clave. En la respuesta, la propiedad id de cada elemento identifica el ID de suscripción que identifica de forma única la suscripción correspondiente. Usarás ese valor para quitar un elemento de la lista en el paso siguiente.
Paso 2: Borra una suscripción

Llama al método subscriptions.delete para borrar una suscripción. Configura el parámetro id de la solicitud con el ID de la suscripción que deseas quitar. Esta solicitud debe autorizarse con OAuth 2.0.

Para completar la solicitud en el Explorador de API, debes configurar el valor de la propiedad id.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
        id=SUBSCRIPTION_ID
```

Consulta la documentación del método subscriptions.delete para ver muestras de código.

Recuperar una lista de los suscriptores del canal del usuario autorizado

Para recuperar una lista de canales que se suscriben al canal del usuario autenticado actualmente, llama al método subscriptions.list y establece el valor del parámetro mySubscribers en true. La solicitud se debe autorizar mediante OAuth 2.0.

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