REST Resource: comments

Ressource : Comment

Un commentaire sur un fichier.

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

object (Reply)

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

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 et 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 (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.

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 le commentaire a été supprimé. Un commentaire supprimé n'a pas de contenu.

htmlContent

string

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

content

string

Contenu en texte brut du commentaire. Ce champ permet de définir le contenu, tandis que htmlContent doit être affiché.

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, par exemple, il s'agit du texte à l'emplacement du commentaire.

quotedFileContent.mimeType

string

Type MIME du contenu cité.

quotedFileContent.value

string

Contenu cité lui-même. Si elle est définie via l'API, elle est interprétée comme du texte brut.

Méthodes

create

Crée un commentaire sur un fichier.

delete

Supprime un commentaire.

get

Obtient un commentaire par ID.

list

Liste les commentaires d'un fichier.

update

Met à jour un commentaire avec la sémantique de correction.