Un recurso commentThread
contiene información sobre una conversación de comentarios de YouTube, que comprende un comentario de nivel superior y respuestas, si existen, a ese comentario. Un recurso commentThread
puede representar comentarios sobre un video o un canal.
Tanto el comentario de nivel superior como las respuestas son, en realidad, recursos comment
anidados en el recurso commentThread
. El recurso commentThread
no necesariamente contiene todas las respuestas a un comentario. Debes usar el método comments.list
si deseas recuperar todas las respuestas de un comentario en particular. Además, ten en cuenta que algunos comentarios no tienen respuesta.
Métodos
La API admite los siguientes métodos para los recursos de commentThreads
:
- list
- Muestra una lista de conversaciones que coinciden con los parámetros de solicitud de 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
en su lugar. Pruébelo ahora.
Representación de recursos
La estructura JSON a continuación 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 API. El valor será youtube#commentThread . |
etag |
etag Es la 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 detalles básicos sobre la conversación de comentarios. También contiene el comentario de nivel superior del subproceso, que es un recurso comment . |
snippet.channelId |
string Corresponde al canal de YouTube asociado a los comentarios de la conversación. (La propiedad snippet.videoId identifica el video).
|
snippet.videoId |
string Indica el ID del video al que hacen referencia los comentarios, si corresponde. Si esta propiedad no está presente o no tiene un valor, la conversación se aplica al canal y no a un video específico. |
snippet.topLevelComment |
object El comentario principal de la conversación. El valor de la propiedad es un recurso comment . |
snippet.canReply |
boolean Esta configuración indica si el usuario actual puede responder a la conversación. |
snippet.totalReplyCount |
unsigned integer Es la cantidad total de respuestas que se enviaron en respuesta al comentario de nivel superior. |
snippet.isPublic |
boolean Esta 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 Lista de una o más respuestas al comentario de nivel superior. Cada elemento de la lista es un recurso comment .La lista contiene una cantidad limitada de respuestas y, a menos que la cantidad de elementos de esta sea igual al valor de la propiedad snippet.totalReplyCount , la lista de respuestas solo será un subconjunto de la cantidad total de respuestas disponibles para el comentario principal. A fin de recuperar todas las respuestas para el comentario de nivel superior, debes llamar al método comments.list y usar el parámetro de solicitud parentId a fin de identificar el comentario del que deseas recuperar las respuestas. |