Comments

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.
  • Si el comentario es un comentario de canal, esta propiedad identifica el canal sobre el cual se trata 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:
  • like
  • none
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:
  • heldForReview
  • likelySpam
  • published
  • rejected
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.