REST Resource: comments

Recurso: Comentario

Un comentario en un archivo de Google Drive.

Algunos métodos de recursos (como comments.update) requieren un commentId. Usa el método comments.list para recuperar el ID de un comentario en un archivo.

Representación 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

Solo salida. El ID del comentario.

kind

string

Solo salida. Siempre es drive#comment.

createdDate

string

Solo salida. Es la fecha en la que se creó este comentario por primera vez.

modifiedDate

string

Solo salida. Es la fecha en la que se modificó por última vez este comentario o alguna de sus respuestas.

fileId

string

Solo salida. Es el archivo al que se refiere este comentario.

status

string

Solo salida. Es el estado de este comentario. Para cambiar el estado, publica una respuesta a un comentario con el estado deseado.

  • open: El comentario aún está abierto.
  • resolved: Una de las respuestas resolvió el comentario.
anchor

string

Es una región del documento representada como una cadena JSON. Para obtener más información sobre cómo definir propiedades de ancla, consulta Cómo agregar comentarios y respuestas.

replies[]

object (CommentReply)

Solo salida. Las respuestas a esta publicación

author

object (User)

Solo salida. Es el autor del comentario. No se propagarán la dirección de correo electrónico ni el ID de permiso del autor.

deleted

boolean

Solo salida. Indica si este comentario se borró. Si se borró un comentario, se borrará el contenido y solo se representará un comentario que alguna vez existió.

htmlContent

string

Solo salida. Es el contenido de este comentario con formato HTML.

content

string

El contenido de texto sin formato que se usó para crear este comentario. No es seguro para HTML y solo debe usarse como punto de partida para editar el contenido de un comentario.

context

object

Es el contexto del archivo sobre el que se hace el comentario.

context.type

string

Es el tipo de MIME del fragmento de contexto.

context.value

string

Representación de datos del segmento del archivo sobre el que se hace el comentario. En el caso de un archivo de texto, por ejemplo, este sería el texto real sobre el que se hace el comentario.

fileTitle

string

Solo salida. Es el título del archivo al que se refiere este comentario.

Métodos

delete

Borra un comentario.

get

Obtiene un comentario por ID.

insert

Crea un comentario nuevo en el archivo determinado.

list

Muestra una lista de los comentarios de un archivo.

patch

Actualiza un comentario existente.

update

Actualiza un comentario existente.