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 em que este comentário ou as respostas dele foram modificados pela última vez.

fileId

string

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

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 dele.
anchor

string

Uma região do documento representada como uma string JSON. Para ver detalhes sobre como definir as propriedades da âncora, consulte 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. Indica se este comentário foi excluído. Se um comentário tiver sido excluído, o conteúdo será apagado, e isso representará apenas um comentário anterior.

htmlContent

string

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

content

string

O conteúdo de texto simples usado para criar este comentário. Isso não é seguro para HTML e só deve ser usado 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 do comentário.

fileTitle

string

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

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.