REST Resource: comments

Risorsa: commento

Un commento su un file in Google Drive.

Alcuni metodi delle risorse (ad esempio 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. Questo valore è sempre drive#comment.

createdDate

string

Solo output. La data di creazione del commento.

modifiedDate

string

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

fileId

string

Solo output. Il file a cui fa riferimento questo commento.

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 da una delle relative risposte.
anchor

string

Una regione del documento rappresentata come stringa JSON. Per informazioni dettagliate sulla definizione delle proprietà di ancoraggio, 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 il commento verrà rappresentato solo come un commento che esisteva in precedenza.

htmlContent

string

Solo output. Contenuti in formato HTML per questo commento.

content

string

I contenuti in testo normale utilizzati per creare questo commento. Non è sicuro per HTML e deve essere utilizzato solo come punto di partenza per apportare modifiche ai contenuti di un commento.

context

object

Il contesto del file a cui viene aggiunto il commento.

context.type

string

Il tipo MIME dello snippet di contesto.

context.value

string

Rappresentazione dei dati del segmento del file a cui si applica il commento. Ad esempio, nel caso di un file di testo, si tratta del testo effettivo a cui si riferisce il commento.

fileTitle

string

Solo output. Il titolo del file a cui fa riferimento il commento.

Metodi

delete

Consente di eliminare un commento.

get

Recupera un commento tramite 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.