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. 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 concerné par ce commentaire.
status

string

Uniquement en sortie. État de ce commentaire. Pour modifier l'état, publiez une réponse au 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 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 sera effacé et ne représentera plus qu'un commentaire qui a existé.
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 sécurisé en HTML et ne doit être utilisé que comme point de départ pour modifier le contenu d'un commentaire.
context

object

Contexte du fichier sur lequel vous commentez.
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 sur lequel porte le commentaire.
fileTitle

string

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

Méthodes

delete

 Supprime un commentaire.

get

 Récupère un commentaire par ID.

insert

 Crée un commentaire sur le fichier donné.

list

 Répertorie les commentaires d'un fichier.

patch

 Met à jour un commentaire existant.

update

 Met à jour un commentaire existant.