Crear permiso en Google Drive, con una API
Comparte 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.
- Identificador
- google_drive_create_permission
La llamada
POST https://connect.reportei.com/api/tools/google_drive_create_permission/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"fileId": "<fileId>",
"role": "reader",
"type": "user"
}
}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. |
| role | string | Sí | Access to grant. fileOrganizer and organizer only exist in shared drives.Valores: reader, commenter, writer, fileOrganizer, organizer |
| type | string | Sí | Who receives it: a user or group by e-mail, everyone in a domain, or anyone with the link.Valores: user, group, domain, anyone |
| emailAddress | string | No | E-mail of the user or group, for type user or group. |
| domain | string | No | Domain, such as example.com, for type domain. |
| allowFileDiscovery | boolean | No | For type domain or anyone, whether the file shows up in search. Without it the file is reached only by its link. |
| expirationTime | string | No | When the access ends, RFC 3339, in the future and at most a year away. Only for type user or group. |
| sendNotificationEmail | boolean | No | Emails users and groups about the share. The default is true; false shares silently. |
| emailMessage | string | No | Plain text message added to the notification e-mail. |
| supportsAllDrives | boolean | No | Set to true when the file can be in a shared drive. |
| view | string | No | Set it to published to grant access to the published view of a Google Form, which decides who can answer it: with type anyone, anyone with the link; with type user, the given email. Omit it for a normal permission on the file.Valores: published |
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_create_permission. 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.
- 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.
- 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.
