REST Resource: comments

Ressource: commentaire

Commentaire sur un fichier dans Google Drive.

Certaines méthodes de ressources (telles que comments.update) nécessitent un commentId. Utilisez la méthode comments.list pour récupérer l'ID d'un commentaire dans un fichier.

Représentation JSON
{
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
Champs
commentId

string

Uniquement en sortie. ID du commentaire.

kind

string

Uniquement en sortie. Il s'agit toujours de drive#comment.

createdDate

string

Uniquement en sortie. Date de création de ce commentaire.

modifiedDate

string

Uniquement en sortie. Date de la dernière modification de ce commentaire ou de l'une de ses réponses.

fileId

string

Uniquement en sortie. Fichier traité par ce commentaire.

status

string

Uniquement en sortie. État de ce commentaire. Vous pouvez modifier l'état en publiant une réponse à un commentaire ayant l'état souhaité.

  • open : le commentaire est toujours ouvert.
  • resolved : le commentaire a été fermé par l'une de ses réponses.
anchor

string

Région du document représentée par une chaîne JSON. Pour en savoir plus sur la définition des propriétés d'ancrage, consultez Ajouter des commentaires et des réponses.

replies[]

object (CommentReply)

Uniquement en sortie. Réponses à ce post.

author

object (User)

Uniquement en sortie. Auteur du commentaire. L'adresse e-mail et l'ID d'autorisation de l'auteur ne seront pas renseignés.

deleted

boolean

Uniquement en sortie. Indique si ce commentaire a été supprimé. Si un commentaire a été supprimé, son contenu est effacé. Il ne s'agit alors que d'un commentaire qui existait auparavant.

htmlContent

string

Uniquement en sortie. Contenu au format HTML pour ce commentaire.

content

string

Contenu en texte brut utilisé pour créer ce commentaire. Cette méthode n'est pas compatible avec le langage HTML et ne doit être utilisée que comme point de départ pour modifier le contenu d'un commentaire.

context

object

Contexte du fichier commenté.

context.type

string

Type MIME de l'extrait de contexte.

context.value

string

Représentation des données du segment du fichier commenté Dans le cas d'un fichier texte, par exemple, il s'agit du texte sur lequel porte le commentaire.

fileTitle

string

Uniquement en sortie. Titre du fichier concerné par ce commentaire.

Méthodes

delete

Supprime un commentaire.

get

Récupère un commentaire par ID.

insert

Crée un commentaire sur le fichier donné.

list

Liste les commentaires d'un fichier.

patch

Met à jour un commentaire existant.

update

Met à jour un commentaire existant.