Un recurso comment
contiene información sobre un solo comentario de YouTube. Un recurso comment
puede representar un comentario sobre un video o un canal. Además, puede ser una respuesta a un comentario de nivel superior o uno de nivel superior.
Métodos
La API admite los siguientes métodos para los recursos comments
:
- list
- Muestra una lista de comentarios que coinciden con los parámetros de solicitud a la API. Pruébala ahora.
- insertar
- Crea una respuesta a un comentario existente. Nota: Para crear un comentario de nivel superior, usa el método
commentThreads.insert
. Pruébalo ahora. - actualizar
- Modifica un comentario. Pruébala ahora.
- borrar
- Borra un comentario. Pruébala ahora.
- setModerationStatus
- Establece el estado de moderación de uno o más comentarios. La solicitud a la API debe estar autorizada por el propietario del canal o video asociado con los comentarios. Pruébala ahora.
- markAsSpam
- Nota: Este método dejó de estar disponible y ya no es compatible.
- Expresa la opinión de la persona que llama que uno o más comentarios deben marcarse como spam.
Representación de recursos
En la siguiente estructura JSON, se muestra el formato de un recurso comments
:
{ "kind": "youtube#comment", "etag": etag, "id": string, "snippet": { "authorDisplayName": string, "authorProfileImageUrl": string, "authorChannelUrl": string, "authorChannelId": { "value": string }, "channelId": string, "textDisplay": string, "textOriginal": string, "parentId": string, "canRate": boolean, "viewerRating": string, "likeCount": unsigned integer, "moderationStatus": string, "publishedAt": datetime, "updatedAt": datetime } }
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#comment . |
etag |
etag La Etag de este recurso. |
id |
string Es el ID que YouTube usa para identificar de forma exclusiva el comentario. |
snippet |
object El objeto snippet contiene detalles básicos sobre el comentario. |
snippet.authorDisplayName |
string El nombre visible del usuario que publicó el comentario. |
snippet.authorProfileImageUrl |
string Corresponde a la URL del avatar del usuario que publicó el comentario. |
snippet.authorChannelUrl |
string Corresponde a la URL del canal de YouTube del autor del comentario (si está disponible). |
snippet.authorChannelId |
object Este objeto contiene información sobre el canal de YouTube del autor del comentario, si está disponible. |
snippet.authorChannelId.value |
string Es el ID del canal de YouTube del autor del comentario (si está disponible). |
snippet.channelId |
string El ID del canal de YouTube asociado con el comentario.
|
snippet.textDisplay |
string El texto del comentario. El texto se puede recuperar en texto sin formato o en HTML. (Los métodos comments.list y commentThreads.list admiten un parámetro textFormat , que especifica el formato de texto deseado).Ten en cuenta que incluso el texto sin formato puede diferir del texto del comentario original. Por ejemplo, es posible que reemplace los vínculos de videos con títulos de videos. |
snippet.textOriginal |
string Corresponde al texto original y sin procesar del comentario tal como se publicó inicialmente o se actualizó por última vez. El texto original solo se muestra si el usuario autenticado puede acceder a él, lo cual solo se garantiza si el usuario es el autor del comentario. |
snippet.parentId |
string Es el ID único del comentario principal. Esta propiedad solo se configura si el comentario se envió como respuesta a otro comentario. |
snippet.canRate |
boolean Este parámetro de configuración indica si el usuario actual puede calificar el comentario. |
snippet.viewerRating |
string La calificación que le dio el usuario a este comentario. Ten en cuenta que, actualmente, esta propiedad no identifica calificaciones de dislike , aunque este comportamiento está sujeto a cambios. Mientras tanto, el valor de la propiedad es like si el usuario calificó el comentario de forma positiva. El valor es none en todos los demás casos, incluso si el usuario dio una calificación negativa o no lo calificó.Los valores válidos para esta propiedad son los siguientes:
|
snippet.likeCount |
unsigned integer La cantidad total de “me gusta” (calificaciones positivas) que recibió el comentario. |
snippet.moderationStatus |
string El estado de moderación del comentario. Esta propiedad solo se muestra si el propietario del canal o del video en el que se realizaron los comentarios solicitados autorizó la solicitud a la API. Además, ten en cuenta que esta propiedad no se configura si la solicitud a la API usó el parámetro de filtro id .Los valores válidos para esta propiedad son los siguientes:
|
snippet.publishedAt |
datetime Fecha y hora en que se publicó el comentario de forma original. El valor se especifica en el formato ISO 8601. |
snippet.updatedAt |
datetime Fecha y hora en que se actualizó el comentario por última vez. El valor se especifica en el formato ISO 8601. |