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, el comentario puede ser un comentario de nivel superior o una respuesta a un comentario 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. El propietario del canal o video asociado con los comentarios debe autorizar la solicitud a la API. Pruébala ahora.
- markAsSpam
- Nota: Este método dejó de estar disponible y ya no se admite.
- Expresa la opinión del emisor de 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 el comentario de manera inequívoca. |
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 Es 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 como texto sin formato o en formato HTML. (Los métodos comments.list y commentThreads.list admiten un parámetro textFormat , que especifica el formato de texto elegido).Incluso el texto sin formato puede diferir del texto del comentario original. Por ejemplo, puede reemplazar los vínculos por los títulos de los videos. |
snippet.textOriginal |
string Es el texto original y sin formato del comentario, tal como se publicó inicialmente o se actualizó por última vez. El texto original solo se muestra al usuario autenticado si es el autor del comentario. |
snippet.parentId |
string El ID único del comentario superior. Esta propiedad solo se establece 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 Es la calificación que el usuario le dio a este comentario. 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 cuando el usuario dio una calificación negativa al comentario 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 el video en el que se realizaron los comentarios solicitados autorizó la solicitud a la API. Además, esta propiedad no se establece 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 Es la fecha y hora en que se publicó el comentario originalmente. El valor se especifica en el formato ISO 8601. |
snippet.updatedAt |
datetime Fecha y hora de la última actualización del comentario. El valor se especifica en el formato ISO 8601. |