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 accepte 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 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

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 ressource de l'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, 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 des vidéos par les titres de ces vidéos.
snippet.textOriginal string
Texte brut d'origine du commentaire tel qu'il a été publié 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 lecteur 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, 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 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 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.