Cette page a été traduite par l'API Cloud Translation.

Comments

Une ressource comment contient des informations sur un seul commentaire YouTube. Une ressource comment peut représenter un commentaire sur une vidéo ou une chaîne. De plus, le commentaire peut être un commentaire de premier niveau ou une réponse à un commentaire de premier niveau.

Méthodes

L'API prend en charge les méthodes suivantes pour les ressources comments:

liste: Renvoie une liste de commentaires correspondant aux paramètres de requête de l'API. Essayer
insérer: Crée une réponse à un commentaire existant. Remarque:Pour créer un commentaire de niveau supérieur, utilisez la méthode commentThreads.insert. Essayez maintenant.
update: Modifie un commentaire. Essayer
supprimer: Supprime un commentaire. Essayer
setModerationStatus: Définit l'état de modération d'un ou de plusieurs commentaires. La demande d'API doit être autorisée par le propriétaire de la chaîne ou de la vidéo associée aux commentaires. Essayer
markAsSpam: Remarque:Cette méthode est obsolète et n'est plus prise en charge.; Indique que l'appelant estime qu'un ou plusieurs commentaires doivent être signalés comme spam.

Représentation de la ressource

La structure JSON suivante montre le format d'une ressource 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
  }
}

Propriétés

Le tableau suivant définit les propriétés qui apparaissent dans cette ressource:

Propriétés
`kind`	`string` Identifie le type de la ressource API. La valeur sera `youtube#comment`.
`etag`	`etag` Etag de cette ressource.
`id`	`string` ID utilisé par YouTube pour identifier de manière unique le commentaire.
`snippet`	`object` L'objet `snippet` contient des informations de base sur le commentaire.
`snippet.authorDisplayName`	`string` Nom à afficher de l'utilisateur ayant publié le commentaire.
`snippet.authorProfileImageUrl`	`string` URL de l'avatar de l'utilisateur qui a publié le commentaire.
`snippet.authorChannelUrl`	`string` URL de la chaîne YouTube de l'auteur du commentaire, si disponible.
`snippet.authorChannelId`	`object` Cet objet encapsule des informations sur la chaîne YouTube de l'auteur du commentaire, le cas échéant.
`snippet.authorChannelId.value`	`string` ID de la chaîne YouTube de l'auteur du commentaire, s'il est disponible.
`snippet.channelId`	`string` ID de la chaîne YouTube associée au commentaire.
`snippet.textDisplay`	`string` Texte du commentaire. Le texte peut être récupéré au format texte brut ou HTML. (Les méthodes `comments.list` et `commentThreads.list` acceptent toutes deux un paramètre `textFormat`, qui spécifie le format de texte choisi.) Même le texte brut peut différer du texte du commentaire d'origine. Par exemple, il peut remplacer les liens vers les vidéos par leurs titres.
`snippet.textOriginal`	`string` Texte brut d'origine du commentaire tel qu'il a été publié initialement ou mis à jour pour la dernière fois. Le texte d'origine n'est renvoyé à l'utilisateur authentifié que s'il est l'auteur du commentaire.
`snippet.parentId`	`string` L'identifiant unique du commentaire parent. Cette propriété n'est définie que si le commentaire a été envoyé en réponse à un autre commentaire.
`snippet.canRate`	`boolean` Ce paramètre indique si l'utilisateur actuel peut évaluer le commentaire.
`snippet.viewerRating`	`string` Note attribuée par le spectateur à ce commentaire. Cette propriété n'identifie pas les notes `dislike`, bien que ce comportement puisse changer. En attendant, la valeur de la propriété est `like` si l'utilisateur a attribué une note positive au commentaire. Dans tous les autres cas, la valeur est `none`, y compris si l'utilisateur a attribué une note négative au commentaire ou s'il ne l'a pas noté. Les valeurs valides pour cette propriété sont les suivantes : `like` `none`
`snippet.likeCount`	`unsigned integer` Nombre total de "J'aime" (notes positives) reçus par le commentaire.
`snippet.moderationStatus`	`string` État de modération du commentaire. Cette propriété n'est renvoyée que si la demande d'API a été autorisée par le propriétaire de la chaîne ou de la vidéo sur laquelle les commentaires demandés ont été publiés. De plus, cette propriété n'est pas définie si la requête API a utilisé le paramètre de filtre `id`. Les valeurs valides pour cette propriété sont les suivantes : `heldForReview` `likelySpam` `published` `rejected`
`snippet.publishedAt`	`datetime` Date et heure de publication initiale du commentaire. La valeur est spécifiée au format ISO 8601.
`snippet.updatedAt`	`datetime` Date et heure de la dernière mise à jour du commentaire. La valeur est spécifiée au format ISO 8601.