Arbeiten mit Aktivitäts-Scopes

Jede Google Workspace und Microsoft 365 Aktivität erfordert bestimmte Berechtigungen oder Scopes, um erfolgreich ausgeführt zu werden. Diese Berechtigungen können für das Benutzer- oder Dienstkonto, das eine Automatisierung ausführt, konfiguriert werden oder nicht, was dazu führen kann, dass Prozesse fehlschlagen.

Ab Version 2.7.21 der Aktivitätspakete Google Workspace und Microsoft 365 enthält jede Aktivität eine Warnung, die Sie über die Scopes informiert, die sie zur ordnungsgemäßen Ausführung benötigt. Die Scopes werden auf jeder Hilfeseite einer Aktivität dokumentiert (Zugriff über die Hilfe- oder F1-Schaltfläche), von den strengsten bis hin zu den am wenigsten restriktiven Berechtigungen.

Hinweis: Wenn ein Scope in den erforderlichen Mindest-Scopes fehlt, bedeutet das nicht, dass eine Aktivität überhaupt nicht funktioniert. Einige Aktivitätsfunktionen funktionieren möglicherweise nicht. Wenn Sie beispielsweise Get File oder Folder List verwenden möchten, aber den Scope Drive.Labels.ReadOnly nicht konfigurieren, kann die Aktivität die Datei abrufen, aber die Drive-Beschriftungen, die der jeweiligen Datei zugeordnet sind, nicht abrufen.

Nehmen wir zum Beispiel Get File List von Google Workspace. Diese Aktivität erfordert eine der folgenden Kombinationen von Scopes:

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

wobei:

• https://www.googleapis.com/auth/drive.readonly AND https://www.googleapis.com/auth/drive.labels.readonly ist der restriktivste Satz von Berechtigungen, der zum Abrufen von Dateien minimal erforderlich ist. Sie erhalten readonly -Zugriff, was bedeutet, dass Sie Google Drive-Dateien anzeigen und herunterladen können, aber keine anderen Aktionen für diese Dateien ausführen können.
• https://www.googleapis.com/auth/drive AND https://www.googleapis.com/auth/drive.labels.readonly ist der am wenigsten eingeschränkte Satz von Berechtigungen, die Sie konfigurieren können. Mit dem https://www.googleapis.com/auth/drive -Scope können Sie alle Ihre Google Drive-Dateien anzeigen, bearbeiten, erstellen und löschen.

Verwenden wir ein weiteres Beispiel aus Microsoft 365 mit Get Email By ID. Diese Aktivität erfordert eine der folgenden Kombinationen von Scopes:

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

wobei:

• Mail.Read ist die restriktivste Berechtigung, die zum Abrufen von E-Mails minimal erforderlich ist. Sie erhalten Mail.Read -Zugriff, d. h. Sie können E-Mails in Ihrem eigenen Posteingang lesen.
• Mail.ReadWrite.Shared ist die am wenigsten eingeschränkte Berechtigung, die Sie konfigurieren können. Mit dem Scope Mail.ReadWrite.Shared können Sie jede E-Mail erstellen, lesen, aktualisieren und löschen, auf die Sie zugreifen können, einschließlich Ihrer eigenen und der E-Mails in einem freigegebenen oder delegierten Posteingang.