Travailler avec des étendues d'activité

Chaque activité Google Workspace et Microsoft 365 nécessite certaines autorisations ou étendues pour s'exécuter correctement. Ces autorisations peuvent ou non être configurées pour l'utilisateur ou le compte de service exécutant une automatisation, ce qui peut entraîner l'échec des processus.

À partir des versions 2.7.21 des packages d'activités Google Workspace et Microsoft 365 , chaque activité comprend un avertissement vous informant de la ou des étendues dont elle a besoin pour s'exécuter correctement. Les étendues sont documentées sur chaque page d’aide d’activité (accessible via le bouton Aide (Help) ou F1), des autorisations les plus restrictives aux moins restrictives.

Remarque : S'il manque une étendue dans les étendues minimales requises, cela ne signifie pas qu'une activité ne fonctionnera pas du tout. Certaines fonctionnalités de l’activité peuvent ne pas fonctionner. Par exemple, si vous souhaitez utiliser Récupérer une liste de fichiers ou de dossiers (Get File or Folder List), mais que vous ne configurez pas l'étendue Drive.Labels.ReadOnly , l'activité pourra récupérer le fichier, mais ne pourra pas récupérer les libellés du Drive associés au fichier en question.

Par exemple, prenons l’activité Obtenir la Google Workspace liste des fichiers ( Get File List ) de . Cette activité nécessite l’une des combinaisons d’étendues suivantes :

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

Où :

• https://www.googleapis.com/auth/drive.readonly AND https://www.googleapis.com/auth/drive.labels.readonly est l'ensemble d'autorisations le plus restrictif requis au minimum pour récupérer des fichiers. L'accès vous donne un accès readonly , ce qui signifie que vous pouvez afficher et télécharger les fichiers Google Drive, mais que vous ne pouvez effectuer aucune autre action sur ces fichiers.
• https://www.googleapis.com/auth/drive AND https://www.googleapis.com/auth/drive.labels.readonly est l'ensemble d'autorisations le moins restrictif que vous pouvez configurer. L'étendue https://www.googleapis.com/auth/drive vous permet de voir, modifier, créer et supprimer tous vos fichiers Google Drive.

Utilisons un autre exemple de Microsoft 365 avec l'activité Obtenir l'e-mail par ID ( Get Email By ID). Cette activité nécessite l’une des combinaisons d’étendues suivantes :

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

Où :

• Mail.Read est l'autorisation la plus restrictive minimale requise pour récupérer des e-mails. Il vous donne un accès Mail.Read , ce qui signifie que vous pouvez lire les e-mails dans votre propre boîte de réception.
• Mail.ReadWrite.Shared est l'autorisation la moins restrictive que vous pouvez configurer. L'étendue Mail.ReadWrite.Shared vous permet de créer, lire, mettre à jour et supprimer tous les messages auxquels vous avez l'autorisation d'accéder, y compris les vôtres et ceux présents dans une boîte de réception partagée ou déléguée.