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 de 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. La fecha en la que se modificó por última vez este comentario o cualquiera de sus respuestas.

fileId

string

Solo salida. El archivo al que se dirige este comentario.

status

string

Solo salida. El estado de este comentario. El estado se puede cambiar mediante la publicación de una respuesta a un comentario con el estado deseado.

  • open: El comentario sigue abierto.
  • resolved: El comentario se resolvió a partir de una de sus respuestas.
anchor

string

Una región del documento representada como una cadena JSON. Para obtener detalles sobre cómo definir las propiedades de los delimitadores, consulta Agrega comentarios y respuestas.

replies[]

object (CommentReply)

Solo salida. 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 del autor ni el ID de permiso.

deleted

boolean

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

htmlContent

string

Solo salida. Contenido en formato HTML para este comentario.

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

El contexto del archivo sobre el que se comenta.

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 comenta. Por ejemplo, en el caso de un archivo de texto, este sería el texto real del que se trata 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.