OAuth-bereiken en -rechten voor Workspace Studio-flowstappen

Als u geautomatiseerde flows maakt en uitvoert in Google Workspace Studio, zijn beveiliging en privacy van gegevens standaard ingebouwd. Workspace Studio gebruikt een identiteitsmodel met minimale rechten. Dit betekent dat geautomatiseerde stromen achtergrondtaken uitvoeren met alleen de minimale rechten die nodig zijn om elke afzonderlijke actie uit te voeren, in plaats van brede, onbeperkte toegang tot het hele Google-account van de gebruiker.

Gebruik deze gids om de vereiste rechten voor elke stap in een flow te bepalen, zodat je je automatisering veilig kunt instellen en inzicht houdt in hoe de gegevens van je organisatie worden geopend. Op deze pagina vind je een toewijzing van elk type processtap en de vereiste Open Authorization-bereiken (OAuth).

Hoe OAuth-bereiken van invloed zijn op je gebruik van Studio

Als u Workspace Studio gebruikt, hebben OAuth-bereiken op de volgende manieren invloed op hoe u uw flows maakt, uitvoert en beheert:

  • Eenmalige autorisatie: De eerste keer dat je een stap toevoegt die interactie heeft met een Google-service (zoals Gmail of Google Drive), krijg je een Google-inlogprompt. Hiermee wordt het specifieke bereik voor die stap geautoriseerd, zodat de flow onafhankelijk op de achtergrond kan worden uitgevoerd.
  • Asynchrone uitvoering op de achtergrond: Nadat een flow is aangezet, wordt deze asynchroon uitgevoerd op de infrastructuur van Google. Het proces voert taken uit (zoals een Agenda-afspraak plannen of een concept schrijven) met alleen de specifieke bereiken die je hebt goedgekeurd, zelfs als je niet actief bent ingelogd.
  • Centraal beheerderstoezicht: Als beheerder kunt u alle actieve flows in uw organisatie bekijken via de instellingen voor toegangsbeheer voor agents in de Beheerdersconsole. U kunt specifieke flows onderbreken of individuele OAuth-bereiken targeten en beperken (zoals Drive-toegang verwijderen terwijl Gmail actief blijft) om de gegevens van uw organisatie te beschermen. Meer informatie

Problemen met onvoldoende rechten oplossen

Als een proces niet wordt uitgevoerd en de foutmelding Onvoldoende rechten of Er is iets misgegaan wordt getoond in het activiteitenlogboek, controleer je het volgende:

  • Autoriseer je workflow opnieuw: Open de workflow in de Builder, klik op Wijzigingen opslaan en volg de prompts in het autorisatievak om verlopen of ontbrekende OAuth-tokens te vernieuwen.
  • Blokkeringen door contextbewuste toegang (Context-Aware Access, CAA): Als uw organisatie apparaat- of IP-beleid strikt handhaaft, kunnen uitvoeringen van achtergrondflows soms worden geblokkeerd. Zorg dat de client-ID van de kernservice Workspace Studio is vrijgesteld van CAA-beperkingen.

Flowstappen en vereiste OAuth-bereiken

In deze tabel staan de standaardstappen van Workspace Studio en de OAuth-bereiken die elke stap nodig heeft om achter de schermen te worden uitgevoerd.

Stapnaam Configuratie en bereik
Stappen voor Studio AI
AIP-primitieven (Vraag het Gemini, Vraag het een Gem, Maken met Gemini, Deep Research, Ongelezen e-mails samenvatten, Extraheren, Beslissen, Samenvatten) https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/cloud_search.query
Algemeen en hulpprogramma's
Volgens een planning N.v.t.
Webhook sturen N.v.t. - Extern 3P
Check of N.v.t. - Interne logica
Een lijst filteren N.v.t. - Interne logica
Gmail
Als ik een e-mail krijg https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger 
Een melding sturen via e-mail https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
Een e-mail sturen https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
E-mailconcepten maken https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
Een e-mail doorsturen https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Stel een antwoord op https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Een e-mail beantwoorden https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Labels toevoegen of verwijderen https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Markeren als gelezen of ongelezen https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Markeren met ster of ster verwijderen https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Archiveren (of verwijderen) https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Google Chat
Als iemand deelneemt aan een ruimte https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
Als ik een chatbericht krijg https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
Als ik word vermeld https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
Als een emoji-reactie wordt toegevoegd https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
Melding sturen in Chat https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships
Chatruimte sturen https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces.create https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships https://www.googleapis.com/auth/chat.spaces
Sturen naar anderen https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships
Bericht beantwoorden https://www.googleapis.com/auth/chat.messages.create https://www.googleapis.com/auth/chat.spaces https://www.googleapis.com/auth/chat.messages.readonly https://www.googleapis.com/auth/chat.spaces.readonly https://www.googleapis.com/auth/chat.memberships.app https://www.googleapis.com/auth/chat.memberships.readonly https://www.googleapis.com/auth/chat.memberships
Google Spreadsheets
Als het blad verandert https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly
Een rij toevoegen https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Rijen updaten https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Rijen wissen https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Content van blad ophalen https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Google Documenten
Een Google-document maken https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
Toevoegen aan een document https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
Google Agenda en Tasks
Op basis van een vergadering https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly 
Taak maken https://www.googleapis.com/auth/tasks
Gebeurtenis maken https://www.googleapis.com/auth/calendar.events
Gasten toevoegen https://www.googleapis.com/auth/calendar.events
Google Drive
Wanneer een item wordt toegevoegd aan een map https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly
Als een bestand wordt bewerkt https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Als er een item in een map wordt bewerkt https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly
Bestand verplaatsen https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Bestand kopiëren https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Bijlagen opslaan https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Een map maken https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Google Meet
Wanneer notulen https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.meet.readonly https://www.googleapis.com/auth/meetings.space.created https://www.googleapis.com/auth/calendar.events.readonly https://www.googleapis.com/auth/meetings.space.readonly
Google Formulieren
Als er een formulierantwoord binnenkomt https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/forms.responses.readonly https://www.googleapis.com/auth/forms.body.readonly https://www.googleapis.com/auth/drive.readonly (alleen voor DLP-bestandsondersteuning in Formulieren)
NotebookLM
Bron toevoegen aan NotebookLM https://www.googleapis.com/auth/drive.readonly
Vragen aan NotebookLM https://www.googleapis.com/auth/drive.readonly