REST Resource: comments

Risorsa: commento

Un commento su 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. È sempre drive#comment.

createdDate

string

Solo output. La data della prima creazione del commento.

modifiedDate

string

Solo output. La data dell'ultima modifica di questo commento o di una delle sue risposte.

fileId

string

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

status

string

Solo output. Lo stato del 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 da una delle sue risposte.
anchor

string

Una regione del documento rappresentata come una stringa JSON. Per maggiori dettagli sulla definizione delle 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. Indica se il commento è stato eliminato. Se un commento è stato eliminato, i contenuti verranno cancellati e questo rappresenterà solo un commento che esisteva.

htmlContent

string

Solo output. Contenuti in formato HTML per questo commento.

content

string

I contenuti in testo normale utilizzati per creare questo commento. Questa sezione non è sicura per 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 relativo al commento.

fileTitle

string

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

Metodi

delete

Elimina un commento.

get

Riceve un commento in base all'ID.

insert

Crea un nuovo commento sul file specificato.

list

Elenca i commenti di un file.

patch

Consente di aggiornare un commento esistente.

update

Consente di aggiornare un commento esistente.