Actualizar archivo en Google Drive, con una API
Renombra, describe, marca con estrella, mueve o envía a la papelera un archivo o carpeta; solo cambian los campos enviados. Para mover, pasa la nueva carpeta en addParents.
- Identificador
- google_drive_update_file
La llamada
POST https://connect.reportei.com/api/tools/google_drive_update_file/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"fileId": "<fileId>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| fileId | string | Sí | File or folder id from List files. |
| name | string | No | New name. |
| description | string | No | New short description. |
| starred | boolean | No | Stars or unstars the file for the account. |
| trashed | boolean | No | true moves the file to the trash, where it stays for 30 days, and false restores it. Only the owner can trash a file of My Drive. |
| addParents | string | No | Folder id from List files to move the file into, or several ids separated by commas. |
| removeParents | string | No | Folder id to take the file out of, usually its current parent from Get file, or several ids separated by commas. |
| supportsAllDrives | boolean | No | Set to true when the file can be in a shared drive. |
Conexiones posibles
Tu cliente conecta su cuenta de Google Drive una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/google_drive, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/google_drive_update_file. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Google Drive
- Listar archivosGETBusca los archivos y carpetas que la cuenta puede ver. Cada archivo trae solo id, name y mimeType, salvo que fields pida más, como webViewLink y modifiedTime.
- Obtener archivoGETObtiene los metadatos de un archivo o carpeta, no el contenido. webViewLink es la dirección que lo abre en el navegador, y parents tiene el id de la carpeta en que está.
- Crear archivoPOSTCrea un archivo solo con metadatos, sin contenido: una carpeta, o un Google Doc, Sheet o presentación Slides vacío, elegido por mimeType. Devuelve id, name y mimeType.
- Copiar archivoPOSTCopia un archivo, como una plantilla de informe, y devuelve el nuevo archivo. Sin parents la copia queda en la misma carpeta que el original. Las carpetas no se pueden copiar.
- Listar unidades compartidasGETLista las unidades compartidas de las que la cuenta es miembro, con id y name. El id va en driveId de Listar archivos. Pasa nextPageToken como pageToken para la página siguiente.
- Listar permisosGETLista quién tiene acceso a un archivo o carpeta. Sin fields cada permiso trae solo campos básicos, como id, type y role: pide emailAddress y displayName para ver más.
- Crear permisoPOSTComparte un archivo o carpeta y devuelve el nuevo permiso con su id. Google envía un correo a los usuarios y grupos, salvo que sendNotificationEmail sea false.
- Actualizar permisoPATCHCambia el role o la expiración de un acceso que ya existe y devuelve el permiso.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
