REST Resource: comments

Ressource : Comment

Un commentaire sur un fichier dans Google Drive.

Certaines méthodes de ressources (comme 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
{
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
Champs
replies[]

object (CommentReply)

Uniquement en sortie. Réponses à ce post.

commentId

string

Uniquement en sortie. ID du commentaire.

kind

string

Uniquement en sortie. Cette valeur est toujours 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 auquel ce commentaire fait référence.

status

string

Uniquement en sortie. État de ce commentaire. Vous pouvez modifier l'état en répondant à un commentaire avec l'état souhaité.

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

string

Région du document représentée sous forme de chaîne JSON. Pour savoir comment définir les propriétés d'ancrage, consultez Ajouter des commentaires et des réponses.

author

object (User)

Uniquement en sortie. Auteur du commentaire. L'adresse e-mail de l'auteur et l'ID d'autorisation 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 sera effacé. Il ne s'agira 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. Ce code n'est pas compatible avec HTML et ne doit être utilisé 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, il s'agit du texte auquel le commentaire fait référence.

fileTitle

string

Uniquement en sortie. Titre du fichier auquel ce commentaire fait référence.

Méthodes

delete

Supprime un commentaire.

get

Obtient 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.