Implementación: Comentarios

Ya no se admite el método comments.markAsSpam.

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

Cómo recuperar los comentarios de un video

Para recuperar una lista de conversaciones de comentarios de un video, llama al método commentThreads.list. Establece los siguientes valores de parámetros en tu solicitud:

  • part: Establece el valor del parámetro en snippet si solo deseas recuperar comentarios de nivel superior o en snippet,replies si también deseas recuperar respuestas a comentarios de nivel superior. (Ten en cuenta que un recurso commentThread no necesariamente contiene todas las respuestas a un comentario, y debes usar el método comments.list si quieres recuperar todas las respuestas de un comentario en particular).

  • videoId: Especifica el ID de video de YouTube del video para el que recuperas los comentarios.

La siguiente solicitud recupera los comentarios y las respuestas a los comentarios relacionados con el video del discurso de apertura de la conferencia de Google I/O de 2014, que tiene el ID de video wtLJPvx7-ys.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&videoId=wtLJPvx7-ys

Cómo recuperar comentarios sobre un canal o asociados con él

La API admite la capacidad de recuperar subprocesos de comentarios sobre un canal o de recuperar todos los subprocesos de comentarios asociados con un canal. En el último caso, la API podría contener comentarios sobre el canal o sobre cualquiera de sus videos.

La siguiente solicitud recupera todas las conversaciones de comentarios asociadas con el canal de YouTube de GoogleDevelopers:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.commentThreads.list?
part=snippet,replies
&allThreadsRelatedToChannelId=UC_x5XG1OV2P6uZZ5FSM9Ttw

Agregando un comentario

Llama al método commentThreads.insert para agregar un comentario nuevo de nivel superior a un canal o un video. Establece el valor del parámetro part de la solicitud en snippet. El cuerpo de la solicitud es un commentThread resource en el que la propiedad snippet.topLevelComment[].snippet[].textOriginal contiene el texto del comentario. Esta solicitud se debe autorizar con OAuth 2.0.

  • Para agregar un comentario a un canal, usa la propiedad snippet.channelId para identificarlo.
  • Para agregar un comentario a un video, usa la propiedad snippet.channelId para identificar el canal que lo subió. También usa la propiedad snippet.videoId para identificar el video.

En la siguiente solicitud de muestra, se agrega un comentario a un video.

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

La solicitud inserta el recurso que se muestra a continuación.

{
 "snippet": {
  "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
  "topLevelComment": {
   "snippet": {
    "textOriginal": "This video is awesome!"
   }
  },
  "videoId": "MILSirUni5E"
 }
}

Cómo responder un comentario

Llama al método comments.insert para responder un comentario. Establece el valor del parámetro part de la solicitud en snippet. El cuerpo de la solicitud es un comment resource en el que la propiedad snippet.textOriginal contiene el texto del comentario. La propiedad snippet.parentId identifica el comentario asociado con la respuesta, y su valor es un commentThread resource's ID. Esta solicitud se debe autorizar con OAuth 2.0.

En la siguiente solicitud de ejemplo, se agrega una respuesta a un comentario existente.

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

La solicitud inserta el recurso que se muestra a continuación. Para ejecutar la solicitud en el Explorador de APIs, usa el valor de la propiedad snippet.parentId para identificar el comentario de nivel superior asociado con la respuesta. En un recurso commentThread, la propiedad snippet.topLevelComment[].id especifica el ID único del recurso.

{
  "snippet": {
    "parentId": "COMMENT_THREAD_ID",
    "textOriginal": "That is true."
  }
}

Cómo actualizar un comentario o una respuesta a un comentario de nivel superior

Para actualizar el texto de un comentario de nivel superior o una respuesta a un comentario de nivel superior, llama al método comments.update. Establece el valor del parámetro part en snippet. En el cuerpo de la solicitud, la propiedad id identifica el comentario que estás modificando y el texto del comentario nuevo.

  • En un recurso commentThread, que identifica un comentario de nivel superior, la propiedad snippet.topLevelComment[].id especifica el ID único del comentario.
  • En un recurso comment, que puede identificar un comentario de nivel superior o una respuesta a un comentario, la propiedad id especifica el ID único del comentario.

En la siguiente solicitud de ejemplo, se actualiza el texto de un comentario existente.

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

El cuerpo de la solicitud contiene el fragmento JSON que se muestra a continuación. Para ejecutar la solicitud en el Explorador de APIs, establece el valor de la propiedad id para identificar el comentario que deseas actualizar. El autor del comentario debe autorizar la solicitud.

{
  "id": "COMMENT_ID",
  "snippet": {
    "textOriginal": "That is true."
  }
}

Cómo establecer el estado de moderación de un comentario

Para establecer el estado de moderación de un comentario, llama al método comments.setModerationStatus. Esta acción se usa cuando el propietario de un canal modera los comentarios en el canal o en sus videos.

Cuando llames a este método, establece el valor del parámetro id para identificar el comentario. Establece también el parámetro moderationStatus en el estado deseado. Solo el propietario del canal en el que aparece un comentario puede ajustar su estado.

  • Paso 1: Recupera los comentarios que están en espera de revisión

    Llama al método commentThreads.list para recuperar los comentarios del canal o del video. Establece el valor del parámetro moderationStatus en heldForReview. La respuesta de la API se podría usar para mostrar una lista de comentarios con una opción para que el propietario del canal publique o rechace cada uno.

  • Paso 2: Actualiza el estado de moderación de un comentario

    Llama al método comments.setModerationStatus para actualizar el estado del comentario. Usa el valor del parámetro id para especificar el ID único del comentario. Establece el parámetro moderationStatus en published o rejected. Si rechazas un comentario, también puedes establecer el parámetro banAuthor en true para evitar que el autor haga comentarios adicionales en el canal o el video.

Nota: La API no proporciona una forma de enumerar ni descubrir comentarios rechazados. Sin embargo, puedes cambiar el estado de moderación de un comentario rechazado a published si conoces el ID único del comentario. Además, una vez que el estado de moderación de un comentario se actualiza a published o rejected, no se puede volver a cambiar a heldForReview.

Quitar un comentario

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

  • Paso 1: Recupera el ID del comentario

    Sigue los pasos anteriores para recuperar una lista de comentarios de un video o canal. Recuerda que solo el autor de un comentario puede borrarlo, por lo que deberás comparar el valor de la propiedad snippet.authorChannelId.value de un recurso comment con el ID de canal del usuario autenticado para determinar si el usuario puede borrar ese comentario en particular.

  • Paso 2: Borra el comentario o el hilo de comentarios

    Una vez que hayas identificado el ID de la conversación de comentarios o el comentario que quieres borrar, llama al método comments.delete para borrarlo. Usa el valor del parámetro id para identificar el ID del comentario o de la conversación de comentarios 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 en la siguiente solicitud por un ID de comentario o de conversación de comentarios válido.

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