REST Resource: comments

Recurso: comentário

Um comentário em um arquivo no Google Drive.

Alguns métodos de recurso, como comments.update, exigem um commentId. Use o método comments.list para recuperar o ID de um comentário em um arquivo.

Representação 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
}
Campos
commentId

string

Apenas saída. O ID do comentário.

kind

string

Apenas saída. É sempre drive#comment.

createdDate

string

Apenas saída. A data em que este comentário foi criado pela primeira vez.

modifiedDate

string

Apenas saída. A data da última modificação deste comentário ou de qualquer uma das respostas dele.

fileId

string

Apenas saída. O arquivo que está recebendo este comentário.

status

string

Apenas saída. O status deste comentário. O status pode ser alterado postando uma resposta a um comentário com o status desejado.

  • open - O comentário ainda está aberto.
  • resolved - O comentário foi resolvido por uma das respostas.
anchor

string

Uma região do documento representada como uma string JSON. Confira mais detalhes sobre como definir as propriedades de âncora em Adicionar comentários e respostas.

replies[]

object (CommentReply)

Apenas saída. Respostas a esta postagem.

author

object (User)

Apenas saída. O autor do comentário. O endereço de e-mail do autor e o ID de permissão não serão preenchidos.

deleted

boolean

Apenas saída. Se este comentário foi excluído. Se um comentário tiver sido excluído, o conteúdo será apagado e isso só representará um comentário que já existiu.

htmlContent

string

Apenas saída. Conteúdo formatado em HTML para este comentário.

content

string

O conteúdo de texto simples usado para criar este comentário. Esse texto não é seguro para HTML e deve ser usado apenas como um ponto de partida para editar o conteúdo de um comentário.

context

object

O contexto do arquivo que está sendo comentado.

context.type

string

O tipo MIME do snippet de contexto.

context.value

string

Representação de dados do segmento do arquivo que está sendo comentado. No caso de um arquivo de texto, por exemplo, esse seria o texto real sobre o qual o comentário se trata.

fileTitle

string

Apenas saída. O título do arquivo que este comentário está tratando.

Métodos

delete

Exclui um comentário.

get

Recebe um comentário por ID.

insert

Cria um novo comentário no arquivo fornecido.

list

Lista os comentários de um arquivo.

patch

Atualiza um comentário existente.

update

Atualiza um comentário existente.