Se usó la API de Cloud Translation para traducir esta página.

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, 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: `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 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: `heldForReview` `likelySpam` `published` `rejected`
`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.