- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Muestra una lista de los comentarios de un archivo.
Solicitud HTTP
GET https://www.googleapis.com/drive/v2/files/{fileId}/comments
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
fileId |
El ID del archivo. |
Parámetros de consulta
Parámetros | |
---|---|
includeDeleted |
Si se configura, se mostrarán todos los comentarios y las respuestas, incluidos los que se borraron y las respuestas (con contenido eliminado). |
maxResults |
La cantidad máxima de debates que se deben incluir en la respuesta, que se utiliza para la paginación. |
pageToken |
Es el token de continuación, que se usa para desplazarse por grandes conjuntos de resultados. Para obtener la siguiente página de resultados, establece este parámetro con el valor de "nextPageToken" de la respuesta anterior. |
updatedMin |
Solo se mostrarán las discusiones que se actualizaron después de esta marca de tiempo. Tiene el formato de una marca de tiempo RFC 3339. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Una lista de comentarios en un archivo de Google Drive.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"kind": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
Campos | |
---|---|
kind |
Siempre es |
selfLink |
Vínculo a esta lista. |
nextLink |
Un vínculo a la página de comentarios siguiente |
items[] |
La lista de comentarios. Si se propaga nextPageToken, es posible que esta lista esté incompleta y se deba recuperar una página adicional de resultados. |
nextPageToken |
El token de la página de la siguiente página de comentarios. Estará ausente si se llega al final de la lista de comentarios. Si por algún motivo se rechaza el token, se debe descartar y se debe reiniciar la paginación desde la primera página de resultados. |
Permisos de autorización
Se necesita uno de los siguientes alcances de OAuth:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly
Algunos permisos están restringidos y requieren una evaluación de seguridad para que tu app los use. Para obtener más información, consulta la guía de autorización.