REST Resource: comments

Ressource: Commentaire

Commentaire sur un fichier.

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
{
  "id": string,
  "kind": string,
  "createdTime": string,
  "modifiedTime": string,
  "resolved": boolean,
  "anchor": string,
  "replies": [
    {
      object (Reply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "htmlContent": string,
  "content": string,
  "quotedFileContent": {
    "mimeType": string,
    "value": string
  }
}
Champs
id

string

Uniquement en sortie. ID du commentaire.

kind

string

Uniquement en sortie. Identifie le type de ressource. Valeur: chaîne fixe "drive#comment".

createdTime

string

Uniquement en sortie. Heure à laquelle le commentaire a été créé (date-heure RFC 3339).

modifiedTime

string

Uniquement en sortie. Date et heure de la dernière modification du commentaire ou de l'une de ses réponses (format RFC 3339).

resolved

boolean

Uniquement en sortie. Indique si 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 Gérer les commentaires et les réponses.

replies[]

object (Reply)

Uniquement en sortie. Liste complète des réponses au commentaire, dans l'ordre chronologique.

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 le commentaire a été supprimé. Un commentaire supprimé ne contient aucun contenu.

htmlContent

string

Uniquement en sortie. Contenu du commentaire avec mise en forme HTML.

content

string

Contenu du commentaire en texte brut. Ce champ permet de définir le contenu, tandis que htmlContent doit s'afficher.

quotedFileContent

object

Contenu du fichier auquel le commentaire fait référence, généralement dans la région d'ancrage. Pour un fichier texte, il s'agit du texte à l'emplacement du commentaire.

quotedFileContent.mimeType

string

Type MIME du contenu cité.

quotedFileContent.value

string

Le contenu cité lui-même. Ce paramètre est interprété en texte brut s'il est défini via l'API.

Méthodes

create

Crée un commentaire sur un fichier.

delete

Supprime un commentaire.

get

Récupère un commentaire par ID.

list

Répertorie les commentaires d'un fichier.

update

Met à jour un commentaire avec une sémantique de correctif.