Archivos
Google Drive en tu producto y en tus agentes de IA, con una API
El toolkit de Google Drive cubre archivos y carpetas, unidades compartidas, permisos y comentarios. Tu producto o agente de IA los llama por Connect, que maneja la conexión OAuth del cliente y registra cada ejecución, sin que construyas la integración.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/google_drive_create_file/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"name": "<name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Google Drive.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Google Drive. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Google Drive.
Carpetas de informes por cliente
Una herramienta de agencia copia una plantilla de informe a la carpeta del cliente y la comparte con las personas correctas mediante permisos.
Revisión en documentos compartidos
Un SaaS lista los comentarios de un Google Doc en revisión y agrega el suyo cuando termina un paso del flujo.
Agente que encuentra archivos
Un agente de IA busca archivos por nombre o tipo, lee sus metadatos y webViewLink, y los mueve o renombra cuando se le pide.
Tools
12 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.
- Actualizar archivoPATCHRenombra, 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.
- 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.
- Eliminar permisoDELETEQuita un acceso de un archivo o carpeta: el usuario, grupo, dominio o enlace pierde el acceso.
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.
Preguntas sobre el toolkit de Google Drive
¿Necesito implementar la API de Google Drive?
No. Connect ya trae 12 tools de Google Drive descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Google Drive?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
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.
