REST Resource: comments

Risorsa: commento

Un commento a un file su Google Drive.

Alcuni metodi delle risorse (come comments.update) richiedono un commentId. Utilizza il metodo comments.list per recuperare l'ID di un commento in un file.

Rappresentazione 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
}
Campi
commentId

string

Solo output. L'ID del commento.

kind

string

Solo output. Il valore è sempre drive#comment.

createdDate

string

Solo output. La data in cui questo commento è stato creato per la prima volta.

modifiedDate

string

Solo output. La data dell'ultima modifica di questo commento o di eventuali risposte.

fileId

string

Solo output. Il file a cui vengono indirizzati i commenti.

status

string

Solo output. Lo stato di questo commento. Lo stato può essere modificato pubblicando una risposta a un commento con lo stato desiderato.

  • open: il commento è ancora aperto.
  • resolved - Il commento è stato risolto con una delle sue risposte.
anchor

string

Una regione del documento rappresentata come stringa JSON. Per maggiori dettagli su come definire le proprietà degli ancoraggi, consulta Aggiungere commenti e risposte.

replies[]

object (CommentReply)

Solo output. Risposte a questo post.

author

object (User)

Solo output. L'autore del commento. L'indirizzo email e l'ID autorizzazione dell'autore non verranno compilati.

deleted

boolean

Solo output. Se il commento è stato eliminato. Se un commento è stato eliminato, i contenuti saranno cancellati e rappresenteranno solo un commento esistente.

htmlContent

string

Solo output. Contenuti in formato HTML per questo commento.

content

string

I contenuti in testo normale utilizzati per creare questo commento. Questa risposta non è compatibile con HTML e deve essere utilizzata solo come punto di partenza per apportare modifiche ai contenuti di un commento.

context

object

Il contesto del file che viene commentato.

context.type

string

Il tipo MIME dello snippet di contesto.

context.value

string

Rappresentazione dei dati del segmento del file commentato. Nel caso di un file di testo, ad esempio, si tratta del testo effettivo a cui si riferisce il commento.

fileTitle

string

Solo output. Il titolo del file a cui si riferisce il commento.

Metodi

delete

Elimina un commento.

get

Riceve un commento per ID.

insert

Crea un nuovo commento sul file specificato.

list

Elenca i commenti di un file.

patch

Aggiorna un commento esistente.

update

Aggiorna un commento esistente.