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 est compatible avec les méthodes suivantes pour les ressources comments :

liste
Renvoie une liste de commentaires correspondant aux paramètres de la requête API. Essayer
insérer
 Crée une réponse à un commentaire existant. Remarque : Pour créer un commentaire de premier niveau, utilisez la méthode commentThreads.insert. Essayez-le 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 requête API doit être autorisée par le propriétaire de la chaîne ou de la vidéo associée aux commentaires. Essayer

Représentation des ressources

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,
    "imageUrl": string
  }
}

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 ressource d'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 qui a posté le commentaire.
snippet.authorProfileImageUrl string
URL de l'avatar de l'utilisateur qui a posté le commentaire.
snippet.authorChannelUrl string
URL de la chaîne YouTube de l'auteur du commentaire, si disponible.
snippet.authorChannelId object
Cet objet contient 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, le cas échéant.
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 des vidéos par les titres des vidéos.
snippet.textOriginal string
Texte brut d'origine du commentaire tel qu'il a été initialement posté 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
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 le spectateur actuel peut évaluer le commentaire.
snippet.viewerRating string
Note attribuée par le spectateur à ce commentaire. Cette propriété n'identifie pas les classifications dislike, mais ce comportement est susceptible de changer. En attendant, la valeur de la propriété est like si le spectateur a évalué le commentaire de manière positive. La valeur est none dans tous les autres cas, y compris si l'utilisateur a attribué une note négative au commentaire ou 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 requête 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 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.
snippet.imageUrl string
URL de l'image ou du GIF animé joint au commentaire, le cas échéant. Cette propriété n'est présente que lorsqu'un commentaire contient une image ou un GIF. L'URL est fournie sous forme de lien signé avec une valeur TTL (Time To Live) de six heures. Elle expire six heures après la récupération.