Trabajar con ámbitos de actividad

Cada actividad de Google Workspace y Microsoft 365 requiere ciertos permisos o ámbitos para ejecutarse correctamente. Estos permisos pueden configurarse o no para el usuario o la cuenta de servicio que ejecuta una automatización, lo que puede hacer que los procesos fallen.

A partir de las versiones 2.7.21 de los paquetes de actividades de Google Workspace y Microsoft 365, cada actividad incluye una advertencia que te informa de los ámbitos que requiere para ejecutarse correctamente. Los ámbitos están documentados en la página de ayuda de cada actividad (accesible a través del botón Ayuda o F1), desde los permisos más restrictivos hasta los menos restrictivos.

Nota: Si falta un ámbito de los ámbitos mínimos requeridos, esto no significa que una actividad no funcionará en absoluto. Algunas funcionalidades de la actividad pueden no funcionar. Por ejemplo, si quieres utilizar Obtener archivo o Lista de carpetas, pero no configuras el ámbito Drive.Labels.ReadOnly , la actividad puede recuperar el archivo, pero no podrá recuperar las etiquetas de Drive asociadas al archivo correspondiente.

Por ejemplo, tomemos la opción Obtener lista de archivos de Google Workspace. Esta actividad requiere una de las siguientes combinaciones de ámbitos:

https://www.googleapis.com/auth/drive.readonly AND https://www.googleapis.com/auth/drive.labels.readonly
OR
https://www.googleapis.com/auth/drive AND https://www.googleapis.com/auth/drive.labels
OR
https://www.googleapis.com/auth/drive.appdata AND https://www.googleapis.com/auth/drive.labels.readonly
OR
https://www.googleapis.com/auth/drive.metadata AND https://www.googleapis.com/auth/drive.labels.readonly
OR
https://www.googleapis.com/auth/drive.metadata.readonly AND https://www.googleapis.com/auth/drive.labels.readonly
OR
https://www.googleapis.com/auth/drive.photos.readonly AND https://www.googleapis.com/auth/drive.labels.readonly
OR
https://www.googleapis.com/auth/drive AND https://www.googleapis.com/auth/drive.labels.readonly

Donde:

• https://www.googleapis.com/auth/drive.readonly AND https://www.googleapis.com/auth/drive.labels.readonly es el conjunto de permisos más restrictivo y mínimamente necesario para recuperar archivos. Te da acceso readonly , lo que significa que puedes ver y descargar archivos de Google Drive, pero no puedes realizar ninguna otra acción en dichos archivos.
• https://www.googleapis.com/auth/drive AND https://www.googleapis.com/auth/drive.labels.readonly es el conjunto de permisos menos restrictivo que puedes configurar. El ámbito https://www.googleapis.com/auth/drive te permite ver, editar, crear y eliminar todos tus archivos de Google Drive.

Usemos otro ejemplo de Microsoft 365 con Obtener correo electrónico por ID. Esta actividad requiere una de las siguientes combinaciones de ámbitos:

Mail.Read
OR
Mail.ReadWrite
OR
Mail.Read.Shared
OR
Mail.ReadWrite.Shared

Donde:

• Mail.Read es el permiso más restrictivo mínimamente necesario para recuperar correos electrónicos. Te da acceso Mail.Read , lo que significa que puedes leer correos electrónicos en tu propia bandeja de entrada.
• Mail.ReadWrite.Shared es el permiso menos restrictivo que puedes configurar. El ámbito Mail.ReadWrite.Shared te permite crear, leer, actualizar y eliminar cualquier correo al que tengas permiso de acceso, incluido el tuyo propio y los de una bandeja de entrada compartida o delegada.