Como trabalhar com escopos de atividades

Cada atividade Google Workspace e Microsoft 365 requer certas permissões ou escopos para ser executada com sucesso. Essas permissões podem ou não estar configuradas para o usuário ou a conta de serviço que executa uma automação, o que pode causar a falha dos processos.

A partir das versões 2.7.21 dos pacotes de atividades Google Workspace WorkSpace e Microsoft 365 , cada atividade inclui um aviso informando os escopos que ela requer para ser executada corretamente. Os escopos estão documentados em cada página de ajuda de atividade (acessível através do botão Ajuda ou F1), das permissões mais restritivas até as menos restritivas.

Observação: se um escopo estiver ausente dos escopos mínimos exigidos, isso não significa que uma atividade não funcionará. Algumas funcionalidades de atividades podem não funcionar. Por exemplo, se você quiser usar Get File or Folder List e não configurar o escopo Drive.Labels.ReadOnly , a atividade poderá recuperar o arquivo, mas não poderá recuperar os rótulos do Drive associados ao respectivo arquivo.

Por exemplo, vamos tomar o Google Workspace Get File List. Essa atividade requer uma das seguintes combinações de escopos:

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

Onde:

• https://www.googleapis.com/auth/drive.readonly AND https://www.googleapis.com/auth/drive.labels.readonly é o conjunto mais restritivo de permissões mínimas necessárias para recuperar arquivos. Isso concede a você acesso readonly , o que significa que você pode ver e baixar arquivos do Google Drive, mas não pode executar nenhuma outra ação nesses arquivos.
• https://www.googleapis.com/auth/drive AND https://www.googleapis.com/auth/drive.labels.readonly é o conjunto de permissões menos restritivo que você pode configurar. O escopo https://www.googleapis.com/auth/drive permite que você veja, edite, crie e exclua todos os seus arquivos do Google Drive.

Vamos usar outro exemplo do Microsoft 365 com Get Email By ID. Essa atividade requer uma das seguintes combinações de escopos:

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

Onde:

• Mail.Read é a permissão mais restritiva mínimamente necessária para recuperar e-mails. Isso concede a você Mail.Read acesso, o que significa que você pode ler emails em sua própria caixa de entrada.
• Mail.ReadWrite.Shared é a permissão menos restritiva que você pode configurar. O escopo Mail.ReadWrite.Shared permite que você crie, leia, atualize e exclua qualquer email que você tenha permissão para acessar, incluindo seu próprio e os em uma caixa de entrada compartilhada ou delegada.