API Reference

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esta referencia de API se organiza por tipo de recurso. Cada tipo de recurso tiene una o más representaciones de datos y uno o más métodos.

Tipos de recursos

  1. Acerca de
  2. Cambios
  3. Canales
  4. Comentarios
  5. Archivos
  6. Permisos
  7. Respuestas
  8. Revisiones
  9. Unidades

Acerca de

Para obtener información detallada sobre los recursos, consulta la página Representación de recursos.

Método Solicitud HTTP Descripción
URI relativos a https://www.googleapis.com/drive/v3, a menos que se indique lo contrario
obtener GET  /about Obtiene información sobre el usuario, su Drive y las capacidades del sistema.

Parámetros de consulta obligatorios: fields

Cambios

Para obtener detalles sobre los recursos de cambios, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relativos a https://www.googleapis.com/drive/v3, a menos que se indique lo contrario
getStartPageToken. GET  /changes/startPageToken Obtiene el pageToken de inicio para enumerar los cambios futuros.
list GET  /changes Enumera los cambios de un usuario o una unidad compartida.

Parámetros de consulta obligatorios: pageToken

reloj POST  /changes/watch Permite suscribirse a los cambios de un usuario. Para usar este método, debes incluir el parámetro de búsqueda pageToken.

Canales

Para obtener detalles sobre los recursos de canales, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relativos a https://www.googleapis.com/drive/v3, a menos que se indique lo contrario
detener POST  /channels/stop Dejar de mirar recursos a través de este canal

Comentarios

Para obtener detalles sobre los recursos de comentarios, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relativos a https://www.googleapis.com/drive/v3, a menos que se indique lo contrario
crear POST  /files/fileId/comments Crea un comentario en un archivo.

Parámetros de consulta obligatorios: fields

borrar DELETE  /files/fileId/comments/commentId Elimina un comentario.
obtener GET  /files/fileId/comments/commentId Obtiene un comentario por su ID.

Parámetros de consulta obligatorios: fields

list GET  /files/fileId/comments Enumera los comentarios de un archivo.

Parámetros de consulta obligatorios: fields

actualizar PATCH  /files/fileId/comments/commentId Actualiza un comentario con semántica de parches.

Parámetros de consulta obligatorios: fields

Archivos

Para obtener detalles sobre los recursos de archivos, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relativos a https://www.googleapis.com/drive/v3, a menos que se indique lo contrario
copia POST  /files/fileId/copy Crea una copia de un archivo y aplica las actualizaciones solicitadas con semántica de parches. No se pueden copiar las carpetas.
crear POST
https://www.googleapis.com/upload/drive/v3/files

y
POST  /files
Crea un archivo.
borrar DELETE  /files/fileId Borra de manera permanente un archivo que pertenece al usuario sin moverlo a la papelera. Si el archivo pertenece a una unidad compartida, el usuario debe ser organizador en la unidad superior. Si el destino es una carpeta, también se borran todos los descendientes que pertenecen al usuario.
vacío DELETE  /files/trash Borra permanentemente todos los archivos de la papelera del usuario.
exportar GET  /files/fileId/export Exporta un documento de Google Workspace al tipo de MIME solicitado y muestra el contenido de bytes exportado. Ten en cuenta que el contenido exportado tiene un límite de 10 MB.

Parámetros de consulta obligatorios: mimeType

generateIds GET  /files/generateIds Genera un conjunto de ID de archivos que se pueden proporcionar en las solicitudes de creación o copia.
obtener GET  /files/fileId Obtiene los metadatos o el contenido de un archivo por ID.
list GET  /files Muestra una lista o busca archivos.
actualizar PATCH
https://www.googleapis.com/upload/drive/v3/files/fileId

y
PATCH  /files/fileId
Actualiza los metadatos o el contenido de un archivo. Cuando llames a este método, solo propaga los campos en la solicitud que deseas modificar. Cuando actualizas campos, algunos pueden cambiar de forma automática, como se modificó. Este método es compatible con la semántica de parches.
reloj POST  /files/fileId/watch Se suscribe a los cambios de un archivo. Si bien puedes establecer un canal para los cambios en un archivo de una unidad compartida, los cambios en un archivo de una unidad compartida no crearán una notificación.
listasdeetiquetas GET  /files/fileId/listLabels Muestra una lista de las etiquetas de un archivo.
modifyLabels POST  /files/fileId/modifyLabels Modifica el conjunto de etiquetas en un archivo.

Permisos

Para obtener detalles sobre los recursos de permisos, consulta la página Representación de recursos.

Método Solicitud HTTP Descripción
URI relativos a https://www.googleapis.com/drive/v3, a menos que se indique lo contrario
crear POST  /files/fileId/permissions Crea un permiso para un archivo o una unidad compartida. Para obtener más información sobre la creación de permisos, consulta Comparte archivos, carpetas y unidades.
borrar DELETE  /files/fileId/permissions/permissionId Borra un permiso.
obtener GET  /files/fileId/permissions/permissionId Obtiene un permiso por ID.
list GET  /files/fileId/permissions Muestra los permisos de un archivo o una unidad compartida.
actualizar PATCH  /files/fileId/permissions/permissionId Actualiza un permiso con semántica de parches.

Respuestas

Para obtener detalles sobre el recurso Respuestas, consulta la página Representación de recursos.

Método Solicitud HTTP Descripción
URI relativos a https://www.googleapis.com/drive/v3, a menos que se indique lo contrario
crear POST  /files/fileId/comments/commentId/replies Crea una respuesta a un comentario.

Parámetros de consulta obligatorios: fields

borrar DELETE  /files/fileId/comments/commentId/replies/replyId Borra una respuesta.
obtener GET  /files/fileId/comments/commentId/replies/replyId Obtiene una respuesta por ID.

Parámetros de consulta obligatorios: fields

list GET  /files/fileId/comments/commentId/replies Muestra una lista con las respuestas a un comentario.

Parámetros de consulta obligatorios: fields

actualizar PATCH  /files/fileId/comments/commentId/replies/replyId Actualiza una respuesta con semántica de parches.

Parámetros de consulta obligatorios: fields

Revisiones

Para obtener más información sobre los recursos de las revisiones, consulta la página Representación de recursos.

Método Solicitud HTTP Descripción
URI relativos a https://www.googleapis.com/drive/v3, a menos que se indique lo contrario
borrar DELETE  /files/fileId/revisions/revisionId Borra de forma permanente una versión del archivo. Solo puedes borrar revisiones de archivos con contenido binario en Google Drive, como imágenes o videos. No se pueden borrar las revisiones de otros archivos, como Hojas de cálculo o Documentos de Google, y la última versión restante.
obtener GET  /files/fileId/revisions/revisionId Obtiene los metadatos o el contenido de una revisión por ID.
list GET  /files/fileId/revisions Enumera las revisiones de un archivo.
actualizar PATCH  /files/fileId/revisions/revisionId Actualiza una revisión con semántica de parches.

Unidades

Para obtener detalles sobre los recursos de Drive, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relativos a https://www.googleapis.com/drive/v3, a menos que se indique lo contrario
crear POST  /drives Crea una unidad compartida.

Parámetros de consulta obligatorios: requestId

borrar DELETE  /drives/driveId Borra de forma permanente una unidad compartida para la que el usuario es organizador. La unidad compartida no puede contener elementos que no están en la papelera.
obtener GET  /drives/driveId Obtiene los metadatos de una unidad compartida por ID.
ocultar POST  /drives/driveId/hide Oculta una unidad compartida en la vista predeterminada.
list GET  /drives Muestra una lista de las unidades compartidas del usuario.
mostrar POST  /drives/driveId/unhide Restablece una unidad compartida a la vista predeterminada.
actualizar PATCH  /drives/driveId Actualiza los metadatos de una unidad compartida.