Implementación: Suscripciones

En los siguientes ejemplos, se muestra cómo usar la API de YouTube Data (v3) para realizar funciones relacionadas con las suscripciones.

Cómo recuperar las suscripciones de un canal

Llama al método subscriptions.list para recuperar las suscripciones de un canal en particular. Existen dos maneras 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 usa el parámetro mine debe estar autorizada con 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 de canal de YouTube único de ese canal. En el siguiente ejemplo, se recupera una lista de los 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: La API muestra un código de respuesta HTTP 403 (Forbidden) si el canal especificado no expone públicamente sus suscripciones y el propietario del canal no autoriza la solicitud.

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 se debe autorizar con OAuth 2.0. El cuerpo de la solicitud es un recurso subscription que establece los siguientes valores:

• El snippet.resourceId.kind contiene el valor youtube#channel.
• La propiedad snippet.resourceId.channelId identifica el canal al que se suscribe. El valor de la propiedad es un ID de canal de YouTube único. El ID del canal se puede obtener de varias maneras, como llamando al método channels.list o recuperando los resultados de la búsqueda de canales.

La siguiente solicitud a la API 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 se debe autorizar 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. En el ejemplo anterior para recuperar las suscripciones de un canal, se 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, con 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 exclusiva la suscripción correspondiente. Usarás ese valor para quitar un elemento de la lista en el siguiente paso.

• Paso 2: Borra una suscripción

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

  Para completar la solicitud en el Explorador de APIs, debes establecer 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.

Recupera 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 con OAuth 2.0.

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