OAuth-omfattningar och behörigheter för Workspace Studio-flödessteg

När du skapar och kör automatiska flöden i Google Workspace Studio är säkerhet och dataintegritet inbyggda som standard. Workspace Studio använder en identitetsmodell med minsta möjliga behörighet. Det innebär att automatiserade flöden kör bakgrundsuppgifter med endast de minsta behörigheter som krävs för att utföra varje enskild åtgärd, i stället för att ha bred, obegränsad åtkomst till användarens hela Google-konto.

Använd den här guiden för att identifiera de behörigheter som krävs för varje steg i ett flöde så att du kan konfigurera automatiseringen på ett säkert sätt och behålla insynen i hur organisationens data används. På den här sidan finns en mappning av varje typ av flödessteg och dess obligatoriska OAuth-omfattningar (Open Authorization).

Så här påverkar OAuth-omfattningar din användning av Studio

När du använder Workspace Studio påverkar OAuth-omfattningar hur du skapar, kör och hanterar dina flöden på följande sätt:

  • Engångsauktorisering: Första gången du lägger till ett steg som interagerar med en Google-tjänst (till exempel Gmail eller Google Drive) visas ett inloggningsmeddelande från Google. Detta auktoriserar den specifika omfattningen för det steget så att flödet kan köras oberoende i bakgrunden.
  • Asynkron bakgrundskörning: När ett flöde har aktiverats körs det asynkront i Googles infrastruktur. Flödet utför uppgifter (som att schemalägga en kalenderhändelse eller skriva ett utkast) med endast de specifika omfattningar som du har godkänt, även när du inte är aktivt inloggad.
  • Centraliserad administratörsöversikt: Som administratör kan du se alla aktiva flöden i organisationen med hjälp av inställningarna för hantering av agentåtkomst i administratörskonsolen. Du kan pausa specifika flöden eller inrikta dig på och begränsa enskilda OAuth-omfattningar (till exempel ta bort Drive-åtkomst men låta Gmail vara aktivt) för att skydda organisationens data. Läs mer

Felsöka otillräckliga behörigheter

Om ett flöde inte körs och felet Otillräckliga behörigheter eller Något gick fel visas i aktivitetsloggen kontrollerar du följande:

  • Auktorisera flödet igen: Öppna flödet i Builder, klicka på Spara ändringar och följ eventuella uppmaningar i auktoriseringsrutan för att uppdatera utlöpta eller saknade OAuth-token.
  • Blockeringar av kontextkänslig åtkomst (CAA): Om organisationen tillämpar enhets- eller IP-policyer strikt kan bakgrundsflödeskörningar ibland blockeras. Se till att klient-id:t för Workspace Studio är undantaget från CAA-begränsningar.

Flödessteg och nödvändiga OAuth-omfattningar

I den här tabellen beskrivs standardstegen i Workspace Studio och de OAuth-omfattningar som krävs för att köra varje steg i bakgrunden.

Stegnamn Konfiguration och omfattning
Steg för Studio AI
AIP-primitiver (Fråga Gemini, Fråga en Gem, Skapa med Gemini, Deep Research, Sammanfatta olästa e-postmeddelanden, Extrahera, Bestäm, Sammanfatta) 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
Allmänt och verktyg
Enligt ett schema Inte tillämpligt
Skicka webhook Inte tillämpligt – extern tredje part
Kontrollera om Inte tillämpligt – intern logik
Filtrera en lista Inte tillämpligt – intern logik
Gmail
När jag får ett e-postmeddelande https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger 
Meddela mig via e-post https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
Skicka ett e-postmeddelande https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Skapa ett e-postutkast https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
Vidarebefordra ett e-postmeddelande https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Skapa ett svarsutkast https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Svara på ett e-postmeddelande https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Lägga till eller ta bort etiketter https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Markera som läst eller oläst https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Stjärnmärka eller ta bort stjärnmärkning https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Arkivera (eller radera) https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Google Chat
När någon går med i ett rum 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
När jag får ett chattmeddelande 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
När jag omnämns 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
När en emojireaktion läggs till 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
Meddela mig i 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
Skicka chattrum 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
Skicka till andra 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
Svara på meddelande 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 Kalkylark
När arbetsbladet ändras https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly
Lägga till en rad https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Uppdatera rader https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Rensa rader https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Hämta innehåll i arbetsblad https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Google Dokument
Skapa ett Google-dokument 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
Lägg till i ett dokument https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
Google Kalender och Tasks
Baserat på ett möte https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly 
Skapa uppgift https://www.googleapis.com/auth/tasks
Skapa händelse https://www.googleapis.com/auth/calendar.events
Lägg till gäster https://www.googleapis.com/auth/calendar.events
Google Drive
När ett objekt läggs till i en mapp 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
När en fil redigeras https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
När ett objekt i en mapp redigeras 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
Flytta fil https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Kopiera fil https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Spara bilagor 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
Skapa en mapp 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
När mötesanteckningar 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 Formulär
När ett formulärsvar kommer in 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 (endast för DLP-filstöd i Formulär)
NotebookLM
Lägg till källa i NotebookLM https://www.googleapis.com/auth/drive.readonly
Fråga NotebookLM https://www.googleapis.com/auth/drive.readonly