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 à laquelle ce commentaire a été créé pour la première fois.

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. Vous pouvez modifier l'état en répondant à un commentaire en précisant 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 des ancres, consultez Ajouter des commentaires et des réponses.

replies[]

object (CommentReply)

Uniquement en sortie. Réponses à ce message

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é, le contenu est effacé. Il ne s'agit que d'un commentaire qui a déjà 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. Cette méthode n'est pas compatible avec 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 réel dont fait l'objet 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 associés à un fichier.

patch

Met à jour un commentaire existant.

update

Met à jour un commentaire existant.