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 de nivel superior o la respuesta a un comentario de nivel superior.

Métodos

La API admite los siguientes métodos para los recursos comments:

list: Devuelve una lista de comentarios que coinciden con los parámetros de solicitud de 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.
actualización: 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 el 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 es compatible.; Expresa la opinión del llamador 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` Es la etiqueta de Etag de este recurso.
`id`	`string` ID que YouTube utiliza para identificar de forma exclusiva el comentario.
`snippet`	`object` El objeto `snippet` contiene información básica sobre el comentario.
`snippet.authorDisplayName`	`string` El nombre visible del usuario que publicó el comentario.
`snippet.authorProfileImageUrl`	`string` Es 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` Es 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 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 original del comentario. Por ejemplo, puede reemplazar los vínculos de video por títulos de video.
`snippet.textOriginal`	`string` Es el texto original del comentario sin procesar tal como se publicó o 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.
`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 otorgó a este comentario. Esta propiedad no identifica las 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, incluido el caso en el que el usuario le 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` Es 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 devuelve si la solicitud a la API fue autorizada por el propietario del canal o el video en el que se realizaron los comentarios solicitados. 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ó originalmente el comentario. El valor se especifica en formato ISO 8601.
`snippet.updatedAt`	`datetime` Fecha y hora de la última actualización del comentario. El valor se especifica en formato ISO 8601.