Zakresy i uprawnienia OAuth dla kroków automatyzacji Workspace Studio

Gdy tworzysz i uruchamiasz zautomatyzowane przepływy pracy w Google Workspace Studio, zabezpieczenia i prywatność danych są domyślnie wbudowane. Workspace Studio korzysta z modelu tożsamości o najmniejszych uprawnieniach, co oznacza, że zautomatyzowane przepływy wykonują zadania w tle, używając tylko minimalnych uprawnień wymaganych do wykonania każdego pojedynczego działania, zamiast mieć szeroki, nieograniczony dostęp do całego konta Google użytkownika.

Aby bezpiecznie skonfigurować automatyzację i zachować wgląd w sposób uzyskiwania dostępu do danych organizacji, skorzystaj z tego przewodnika, aby określić uprawnienia wymagane na każdym etapie procesu. Na tej stronie znajdziesz mapowanie poszczególnych typów kroków przepływu i wymaganych zakresów protokołu OAuth.

Jak zakresy protokołu OAuth wpływają na korzystanie ze Studio

Gdy używasz Workspace Studio, zakresy OAuth wpływają na sposób tworzenia i uruchamiania automatyzacji oraz zarządzania nimi w następujący sposób:

  • Jednorazowa autoryzacja: gdy po raz pierwszy dodasz krok, który wchodzi w interakcję z usługą Google (np. Gmailem lub Dyskiem Google), pojawi się potwierdzenie od Google. Spowoduje to autoryzację określonego zakresu dla tego kroku, dzięki czemu przepływ będzie mógł działać niezależnie w tle.
  • Asynchroniczne wykonywanie w tle: po włączeniu przepływ działa asynchronicznie w infrastrukturze Google. Proces wykonuje zadania (takie jak zaplanowanie wydarzenia w Kalendarzu czy napisanie wersji roboczej) tylko w ramach zatwierdzonych przez Ciebie zakresów, nawet gdy nie jesteś zalogowany(-a).
  • Scentralizowany nadzór administracyjny: jako administrator możesz wyświetlać wszystkie aktywne przepływy w organizacji, korzystając z ustawień Zarządzanie dostępem agentów w konsoli administracyjnej. Aby chronić bezpieczeństwo danych organizacji, możesz wstrzymać określone przepływy lub kierować i ograniczać poszczególne zakresy protokołu OAuth (np. usunąć dostęp do Dysku, pozostawiając aktywny Gmail). Więcej informacji

Rozwiązywanie problemów z niewystarczającymi uprawnieniami

Jeśli przepływ nie działa i w historii aktywności pojawia się błąd „Niewystarczające uprawnienia” lub „Coś poszło nie tak”, sprawdź te kwestie:

  • Ponownie autoryzuj przepływ: otwórz przepływ w Kreatorze, kliknij Zapisz zmiany i postępuj zgodnie z instrukcjami w polu autoryzacji, aby odświeżyć wygasłe lub brakujące tokeny OAuth.
  • Blokady dostępu zależnego od kontekstu: jeśli Twoja organizacja rygorystycznie egzekwuje zasady dotyczące urządzeń lub adresów IP, wykonywanie przepływów w tle może być czasami blokowane. Upewnij się, że podstawowy identyfikator klienta Workspace Studio jest wyłączony z ograniczeń CAA.

Kroki funkcji typu flow i wymagane zakresy protokołu OAuth

W tej tabeli znajdziesz standardowe kroki Workspace Studio i zakresy protokołu OAuth, których każdy krok wymaga do działania za kulisami.

Nazwa etapu Konfiguracja i zakres
Kroki w AI Studio
Elementy podstawowe AIP (Zapytaj Gemini, Zapytaj Gema, Utwórz z Gemini, Deep Research, Podsumuj nieprzeczytane e-maile, Wyodrębnij, Zdecyduj, Podsumuj) 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
Ogólne i narzędzia
Zgodnie z harmonogramem Nie dotyczy
Wyślij webhooka Nie dotyczy – zewnętrzna usługa zewnętrznego dostawcy
Sprawdź, czy: Nie dotyczy – logika wewnętrzna
Filtrowanie listy Nie dotyczy – logika wewnętrzna
Gmail
Gdy dostanę e-maila https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger 
Powiadom mnie e-mailem https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
Wyślij e-maila https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Napisz wersję roboczą e-maila https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
Przekazywanie dalej e-maila https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Utwórz wersję roboczą odpowiedzi https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Odpowiadanie na e-maila https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Dodawanie i usuwanie etykiet https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Oznaczanie jako przeczytane lub nieprzeczytane https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Oznaczanie gwiazdką i usuwanie oznaczenia gwiazdką https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Archiwizowanie (lub usuwanie) https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Google Chat
Gdy ktoś dołącza do pokoju 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
Gdy otrzymam wiadomość na czacie 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
Gdy ktoś doda o mnie wzmiankę 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
Gdy dodasz reakcję emotikonem 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
Powiadom mnie w Google 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
Wysyłanie pokoju czatu 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
Wyślij do innych osób 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
Odpowiadanie na wiadomość 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
Arkusze Google
Gdy arkusz się zmieni https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly
Dodawanie wiersza https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Aktualizowanie wierszy https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Wyczyść wiersze https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Pobierz zawartość arkusza https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Dokumenty Google
Tworzenie dokumentu Google 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
Dodaj do dokumentu https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
Kalendarz Google i Lista zadań
Na podstawie spotkania https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly 
Utwórz zadanie https://www.googleapis.com/auth/tasks
Tworzenie zdarzeń https://www.googleapis.com/auth/calendar.events
Dodawanie gości https://www.googleapis.com/auth/calendar.events
Dysk Google
Gdy element zostanie dodany do folderu 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
Gdy plik zostanie edytowany https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Gdy element w folderze zostanie edytowany 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
Przenoszenie pliku https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Kopiowanie pliku https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Zapisywanie załączników 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
Tworzenie folderu 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
Kiedy notatki ze spotkania 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
Formularze Google
Gdy pojawi się odpowiedź z formularza 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 (tylko w przypadku obsługi plików DLP w Formularzach)
NotebookLM
Dodawanie źródła do NotebookLM https://www.googleapis.com/auth/drive.readonly
Zapytaj NotebookLM https://www.googleapis.com/auth/drive.readonly