Workspace Studio akış adımları için OAuth kapsamları ve izinleri

Google Workspace Studio'da otomatik akışlar oluşturup çalıştırdığınızda güvenlik ve veri gizliliği varsayılan olarak yerleşiktir. Workspace Studio, en az ayrıcalıklı kimlik modelini kullanır. Bu nedenle, otomatik akışlar, kullanıcının Google Hesabı'nın tamamına geniş ve sınırsız erişim yerine, arka plan görevlerini yalnızca her bir işlemi gerçekleştirmek için gereken minimum izinleri kullanarak çalıştırır.

Otomasyonunuzu güvenli bir şekilde yapılandırmak ve kuruluşunuzun verilerine nasıl erişildiğini görünür kılmak için bu kılavuzu kullanarak bir akıştaki her adım için gereken izinleri belirleyin. Bu sayfada, her akış adımı türü ve gerekli Açık Yetkilendirme (OAuth) kapsamlarının eşlemesi sağlanmaktadır.

OAuth kapsamlarının Studio kullanımınızı nasıl etkilediği

Workspace Studio'yu kullandığınızda OAuth kapsamları, akışlarınızı oluşturma, çalıştırma ve yönetme şeklinizi şu şekilde etkiler:

  • Tek seferlik yetkilendirme: Google hizmetleriyle (ör. Gmail veya Google Drive) etkileşimde bulunan bir adım eklediğinizde ilk kez Google oturum açma istemi alırsınız. Bu işlem, akışın arka planda bağımsız olarak çalışabilmesi için söz konusu adımın kapsamını yetkilendirir.
  • Eş zamansız arka plan yürütme: Bir akış etkinleştirildikten sonra Google'ın altyapısında eş zamansız olarak çalışır. Akış, etkin olarak oturum açmadığınızda bile yalnızca onayladığınız belirli kapsamları kullanarak görevleri (ör. Takvim etkinliği planlama veya taslak yazma) gerçekleştirir.
  • Merkezi yönetici denetimi: Yönetici olarak, Yönetici Konsolu'ndaki Aracı Erişimi Yönetimi ayarlarını kullanarak kuruluşunuzdaki tüm etkin akışları görüntüleyebilirsiniz. Kuruluşunuzun verilerini güvende tutmak için belirli akışları duraklatabilir veya tek tek OAuth kapsamlarını (ör. Gmail'i etkin bırakırken Drive erişimini kaldırma) hedefleyip kısıtlayabilirsiniz. Daha fazla bilgi

Yetersiz izinlerle ilgili sorunları giderme

Bir akış çalışmıyorsa ve Etkinlik Günlüğü'nde "Yetersiz İzin" veya "Bir hata oluştu" hatası gösteriliyorsa aşağıdakileri kontrol edin:

  • Akışınızı yeniden yetkilendirin: Akışı Oluşturucu'da açın, Değişiklikleri Kaydet'i tıklayın ve süresi dolmuş veya eksik OAuth jetonlarını yenilemek için yetkilendirme kutusundaki istemleri uygulayın.
  • Bağlama Duyarlı Erişim (CAA) engellemeleri: Kuruluşunuz cihaz veya IP politikalarını katı bir şekilde uyguluyorsa arka plan akışı yürütmeleri bazen engellenebilir. Temel Workspace Studio istemci kimliğinin CAA kısıtlamalarından muaf olduğundan emin olun.

Akış adımları ve gerekli OAuth kapsamları

Bu tabloda, standart Workspace Studio adımları ve her adımın arka planda çalışması için gereken OAuth kapsamları özetlenmektedir.

Adım adı Yapılandırma ve kapsam
Studio yapay zeka adımları
AIP temel işlevleri (Gemini'a Sor, Gem'e Sor, Gemini ile Oluştur, Deep Research, Okunmamış E-postaları Özetle, Ayıkla, Karar Ver, Özetle) 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
Genel ve yardımcı programlar
Programlı olarak Yok
Webhook gönderme Yok - Harici 3. taraf
Şunları kontrol edin: Geçerli değil - Dahili mantık
Listeyi filtreleme Geçersiz - Dahili mantık
Gmail
E-posta aldığımda https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger 
Beni e-postayla bilgilendir https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
E-posta gönderme https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
E-posta taslağı oluşturma https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
E-posta yönlendirme https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Yanıt taslağı oluştur https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
E-postaları yanıtlama https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
Etiket ekleme veya kaldırma https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Okundu veya okunmadı olarak işaretleme https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Yıldız ekleme veya yıldızı kaldırma https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Arşivleme (veya silme) https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Google Chat
Bir kullanıcı alana katıldığında 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
Sohbet mesajı aldığımda 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
Benden bahsedildiğinde 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
Emoji tepkisi eklendiğinde 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
Chat'te beni bilgilendir 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
Sohbet alanı gönderme 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
Başkalarına gönderme 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
Mesajları yanıtlama 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 E-Tablolar
Sayfa değiştiğinde https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly
Satır ekleme https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Satırları güncelleme https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Satırları temizle https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Sayfa içeriğini alma https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Google Dokümanlar
Google Dokümanı oluşturma 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
Dokümana ekleme https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
Google Takvim ve Görevler
Toplantıya göre https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly 
Görev oluşturma https://www.googleapis.com/auth/tasks
Etkinlik oluşturma https://www.googleapis.com/auth/calendar.events
Davetli ekleme https://www.googleapis.com/auth/calendar.events
Google Drive
Bir klasöre öğe eklendiğinde 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
Bir dosya düzenlendiğinde https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Bir klasördeki öğe düzenlendiğinde 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
Dosyayı taşıma https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Dosyayı kopyalama https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
Ekleri kaydetme 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
Klasör oluşturma 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
Toplantı notları 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 Formlar
Form yanıtı geldiğinde 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 (yalnızca Formlar'da DLP dosya desteği için)
NotebookLM
NotebookLM'e kaynak ekleme https://www.googleapis.com/auth/drive.readonly
NotebookLM'e soru sorma https://www.googleapis.com/auth/drive.readonly