CommentThreads

Un recurso commentThread contiene información sobre un hilo de comentarios de YouTube, que comprende un comentario de nivel superior y respuestas a ese comentario, si hubiera alguno. Un recurso commentThread representa los comentarios de un video.

Tanto el comentario de nivel superior como las respuestas son, en realidad, comment recursos anidados dentro del recurso commentThread. El recurso commentThread no necesariamente contiene todas las respuestas a un comentario; además, debes usar el método comments.list si deseas recuperar todas las respuestas de un comentario en particular. Algunos comentarios no tienen respuestas.

Métodos

La API admite los siguientes métodos para los recursos commentThreads:

list

Muestra una lista de hilos de comentarios que coinciden con los parámetros de solicitud a la API. Pruébala ahora.

insertar

Crea un nuevo comentario de nivel superior. Para agregar una respuesta a un comentario existente, usa el método comments.insert. Pruébalo ahora.

Representación de recursos

La estructura JSON muestra el formato de un recurso commentThreads:

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
kind	string Identifica el tipo de recurso de la API. El valor será youtube#commentThread.
etag	etag Etag de este recurso.
id	string ID que YouTube utiliza para identificar de forma exclusiva la conversación de comentarios.
snippet	object El objeto snippet contiene información básica sobre el hilo de comentarios. También contiene el comentario de nivel superior del subproceso, que es un recurso comment.
snippet.channelId	string El canal de YouTube asociado a los comentarios de la conversación. La propiedad snippet.videoId identifica el video.
snippet.videoId	string El ID del video al que hacen referencia los comentarios.
snippet.topLevelComment	object El comentario de nivel superior de la conversación. El valor de la propiedad es un recurso comment.
snippet.canReply	boolean Este parámetro de configuración indica si el usuario actual puede responder a la conversación.
snippet.totalReplyCount	unsigned integer La cantidad total de respuestas que se enviaron como respuesta al comentario de nivel superior.
snippet.isPublic	boolean Este parámetro de configuración indica si todos los usuarios de YouTube pueden ver la conversación, incluidos todos sus comentarios y respuestas.
replies	object El objeto replies es un contenedor que contiene una lista de respuestas al comentario, si las hay. La propiedad replies.comments representa la lista de comentarios en sí.
replies.comments[]	list Una lista de una o más respuestas al comentario de nivel superior. Cada elemento de la lista es un recurso de comment. La lista contiene una cantidad limitada de respuestas y, a menos que la cantidad de elementos de la lista sea igual al valor de la propiedad snippet.totalReplyCount, la lista de respuestas solo es un subconjunto de la cantidad total de respuestas disponibles para el comentario de nivel superior. Para recuperar todas las respuestas del comentario de nivel superior, debes llamar al método comments.list y usar el parámetro de solicitud parentId para identificar el comentario para el que deseas recuperar las respuestas.