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
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:
|
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:
|
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:
|
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:
|
list |
GET /files/fileId/comments
|
Enumera los comentarios de un archivo.
Parámetros de consulta obligatorios:
|
actualizar |
PATCH /files/fileId/comments/commentId
|
Actualiza un comentario con semántica de parches.
Parámetros de consulta obligatorios:
|
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
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:
|
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
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:
|
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:
|
list |
GET /files/fileId/comments/commentId/replies
|
Muestra una lista con las respuestas a un comentario.
Parámetros de consulta obligatorios:
|
actualizar |
PATCH /files/fileId/comments/commentId/replies/replyId
|
Actualiza una respuesta con semántica de parches.
Parámetros de consulta obligatorios:
|
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:
|
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. |