Implementación: videos

En este ejemplo, se recuperan los videos subidos a un canal en particular. El ejemplo tiene dos pasos:

• Paso 1: Recupera el ID de la playlist de los videos subidos del canal

  Llama al método channels.list para recuperar el ID de la playlist que contiene los videos subidos del canal. El valor del parámetro part de la solicitud debe incluir contentDetails como una de las partes del recurso channel que se recuperan. En la respuesta de la API, la propiedad contentDetails.relatedPlaylists.uploads contiene el ID de la playlist.

  Existen varias formas de identificar el canal:

  • Establece el valor del parámetro mine en true para recuperar información del canal de YouTube del usuario autenticado actualmente. Tu solicitud debe estar autorizada con OAuth 2.0.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
            part=contentDetails
            &mine=true

  • Establece el parámetro forUsername en un nombre de usuario de YouTube para recuperar información del canal asociado con ese nombre de usuario. En este ejemplo, se establece el valor del parámetro forUsername en Google para recuperar información del canal oficial de YouTube de Google.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
            part=contentDetails
            &forUsername=Google

  • Establece el parámetro id en el ID del canal de YouTube que identifica de forma exclusiva el canal para el que recuperas información. En este ejemplo, se establece el parámetro id en UCK8sQmJBp8GCxrOtXWBpyEA, que también identifica el canal oficial de YouTube de Google.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
            part=contentDetails
            &id=UCK8sQmJBp8GCxrOtXWBpyEA

• Paso 2: Recupera la lista de videos subidos

  Llama al método playlistItems.list para recuperar la lista de videos subidos. Establece el valor del parámetro playlistId en el valor que obtuviste en el paso 1. En este ejemplo, el valor del parámetro se establece en UUK8sQmJBp8GCxrOtXWBpyEA, que es la lista de videos subidos al canal oficial de YouTube de Google.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.playlistItems.list?
          part=snippet,contentDetails,status
          &playlistId=UUK8sQmJBp8GCxrOtXWBpyEA

En este ejemplo, se muestra cómo recuperar una lista de los videos más populares de YouTube, que se seleccionan con un algoritmo que combina muchos indicadores diferentes para determinar la popularidad general.

Para recuperar la lista de videos más populares, llama al método videos.list y establece el valor del parámetro chart en mostPopular. Cuando recuperes esta lista, también puedes establecer uno o ambos de los siguientes parámetros:

• regionCode: Le indica a la API que muestre una lista de videos de la región especificada.
• videoCategoryId: Identifica la categoría de video para la que se deben recuperar los videos más populares.

Con la siguiente solicitud, se recuperan los videos deportivos más populares en España:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &chart=mostPopular
        &regionCode=es
        &videoCategoryId=17

Dado que el Explorador de APIs no admite la carga de archivos, esta descripción no incluye un vínculo a un ejemplo ejecutable. Los siguientes recursos te ayudarán a modificar tu aplicación para que pueda subir videos con la API de la versión 3:

• La documentación del método videos.insert de la API contiene varios ejemplos de código que explican cómo subir un video con diferentes lenguajes de programación.

• En la guía Cargas reanudables, se explica la secuencia de solicitudes HTTP que usa una aplicación para subir videos con un proceso de carga reanudable. La guía está dirigida principalmente a desarrolladores que no pueden usar las bibliotecas cliente de la API de Google, algunas de las cuales proporcionan compatibilidad nativa con cargas reanudables.

• El ejemplo de JavaScript para subir un video usa CORS (uso compartido de recursos entre dominios) para demostrar cómo subir un archivo de video a través de una página web. La biblioteca de carga de CORS que usa la API de v3 admite de forma nativa la carga reanudable. Además, el ejemplo muestra cómo verificar el estado de un video subido recuperando la parte processingDetails del recurso video, así como cómo controlar los cambios de estado del video subido.

En este ejemplo, se muestra cómo verificar el estado de un video subido. Los videos subidos se podrán ver de inmediato en el feed de videos subidos del usuario autenticado. Sin embargo, el video no se podrá ver en YouTube hasta que se haya procesado.

• Paso 1: Sube el video

  Llama al método videos.insert para subir el video. Si la solicitud se realiza correctamente, la respuesta de la API contendrá un recurso video que identifica el ID de video único del video subido.

• Paso 2: Verifica el estado del video

  Llama al método videos.list para verificar el estado del video. Establece el valor del parámetro id en el ID de video que obtuviste en el paso 1. Establece el valor del parámetro part en processingDetails.

  Si la solicitud se controla correctamente, la respuesta de la API contendrá un recurso video. Verifica el valor de la propiedad processingDetails.processingStatus para determinar si YouTube aún está procesando el video. El valor de la propiedad cambiará a algo distinto de processing, como succeeded o failed, cuando YouTube termine de procesar el video.

  El cuerpo de la solicitud es un recurso video en el que la propiedad id especifica el ID del video que quieres borrar. En este ejemplo, el recurso también contiene un objeto recordingDetails.

  La siguiente solicitud verifica el estado de un video. 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.videos.list?
          part=snippet,processingDetails
          &id=VIDEO_ID

Nota: Tu aplicación podría sondear la API para verificar periódicamente el estado de un video subido recientemente. Una vez que se procese el video, tu aplicación podría crear un boletín informativo o continuar con otra acción según el estado del video.

En este ejemplo, se muestra cómo actualizar un video para agregar información sobre la hora y el lugar en el que se grabó. El ejemplo tiene los siguientes pasos:

• Paso 1: Recupera el ID del video

  Sigue los pasos anteriores para recuperar los videos subidos del canal del usuario autenticado actualmente. La lista se podría usar para mostrar una lista de videos, con el ID de cada video como clave.

  Nota: Existen muchas otras formas de obtener IDs de video, como recuperar resultados de la búsqueda o enumerar elementos en una playlist. Sin embargo, como solo el propietario puede actualizar un video, es probable que el primer paso de este proceso sea recuperar una lista de los videos que pertenecen al usuario que autoriza la solicitud a la API.

• Paso 2: Actualiza un video

  Llama al método videos.update para actualizar un video específico. Establece el valor del parámetro part en recordingDetails. (El valor del parámetro depende de los campos de metadatos de los videos que se actualizan).

  El cuerpo de la solicitud es un recurso video en el que la propiedad id especifica el ID del video que estás actualizando. En este ejemplo, el recurso también contiene un objeto recordingDetails.

  En el siguiente recurso de muestra, se indica que el video se grabó el 30 de octubre de 2013 en Boston:

  {
    "id": "VIDEO_ID",
    "recordingDetails": {
      "location": {
        "latitude": "42.3464",
        "longitude": "-71.0975"
      }
      "recordingDate": "2013-10-30T23:15:00.000Z"
    }
  }

  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.videos.update?
          part=snippet

Puedes usar el método thumbnails.set de la API de v3 para subir una imagen de miniatura personalizada y configurarla para un video. En tu solicitud, el valor del parámetro videoId identifica el video para el que se usará la miniatura.

Esta consulta no se puede probar con el Explorador de APIs porque no admite la carga de archivos multimedia, lo cual es un requisito para este método.

Muestras de código relacionadas: PHP, Python

En este ejemplo, se muestra cómo borrar un video. El ejemplo tiene los siguientes pasos:

• Paso 1: Recupera el ID del video

  Sigue los pasos anteriores para recuperar los videos subidos del canal del usuario autenticado actualmente. La lista se podría usar para mostrar una lista de videos, con el ID de cada video como clave.

  Nota: Existen muchas otras formas de obtener IDs de video, como recuperar resultados de la búsqueda o enumerar elementos en una playlist. Sin embargo, como solo el propietario puede borrar un video, es probable que el primer paso de este proceso sea recuperar una lista de los videos que pertenecen al usuario que autoriza la solicitud a la API.

• Paso 2: Borra un video

  Llama al método videos.delete para borrar un video específico. En la solicitud, el parámetro id especifica el ID del video que quieres borrar. La solicitud se debe autorizar con OAuth 2.0. Si pruebas esta consulta en el Explorador de APIs, deberás reemplazar el valor del parámetro id por un ID de video válido.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.delete?
          id=VIDEO_ID
  

En este ejemplo, se muestra cómo denunciar un video que contiene contenido abusivo. El ejemplo tiene los siguientes pasos:

• Paso 1: Recupera los IDs que explican por qué se denuncia el video

  Envía una solicitud autorizada al método videoAbuseReportReasons.list para recuperar una lista de motivos válidos para marcar un video. El siguiente recurso videoAbuseReportReason de muestra contiene información para marcar un video que incluye spam o contenido engañoso.

  {
    "kind": "youtube#videoAbuseReportReason",
    "etag": "\"tbWC5XrSXxe1WOAx6MK9z4hHSU8/Or2VqBIilpHU7j__oPzUFCvGVBw\"",
    "id": "S",
    "snippet": {
      "label": "Spam or misleading",
      "secondaryReasons": [
        {
          "id": "27",
          "label": "Spam or mass advertising"
        },
        {
          "id": "28",
          "label": "Misleading thumbnail"
        },
        {
          "id": "29",
          "label": "Malware or phishing"
        },
        {
          "id": "30",
          "label": "Pharmaceutical drugs for sale"
        },
        {
          "id": "31",
          "label": "Other misleading info"
        }
      ]
    }
  }

  Como se muestra en el recurso, este motivo está asociado con una lista de motivos secundarios. Cuando marques un video por incluir spam, debes proporcionar el ID del motivo y te recomendamos que también proporciones un motivo secundario.

• Paso 2: Marca el video por contenido abusivo

  Envía una solicitud autorizada al método videos.reportAbuse para denunciar el video. El cuerpo de la solicitud es un objeto JSON que identifica el video que se marca y el motivo por el que se marca. Como se señaló en el paso 1, para algunos tipos de motivos, se admite y recomienda un motivo secundario.

  La propiedad videoId del objeto JSON identifica el video que se marca.

  En el siguiente objeto JSON de muestra, se marca un video por incluir spam o contenido engañoso y, más específicamente, por usar una miniatura engañosa. Como se muestra en el objeto JSON de muestra anterior, el ID para el contenido Spam o engañoso es S. El ID de una miniatura engañosa es 28.

  {
    "videoId": "VIDEO_ID",
    "reasonId": "S",
    "secondaryReasonId": "28",
    "comments": "Testing the video flagging feature.",
    "language": "en"
  }

  La solicitud videos.reportAbuse debe estar autorizada con OAuth 2.0. El siguiente vínculo carga el objeto JSON anterior en el Explorador de APIs. Para probar la consulta, debes reemplazar el valor de la propiedad videoId por un ID de video válido. Recuerda que, si envías esta solicitud, se marcará el video.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.reportAbuse