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 sağlanır. Workspace Studio, en az ayrıcalıklı kimlik modelini kullanır. Bu modelde otomatik akışlar, kullanıcının Google Hesabı'nın tamamına geniş ve kısıtlanmamış erişim sağlamak yerine, yalnızca her bir işlemi gerçekleştirmek için gereken minimum izinleri kullanarak arka plan görevlerini çalıştırır.

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

OAuth kapsamları, Studio kullanımınızı nasıl etkiler?

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ı ilk kez eklediğinizde Google oturum açma istemi gösterilir. Bu işlem, ilgili adım için belirli kapsamı yetkilendirir. Böylece akış, arka planda bağımsız olarak çalışabilir.
  • 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ış, oturumunuz etkin bir şekilde açık olmasa 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 Temsilci Erişim 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ı hedefleyip kısıtlayabilirsiniz (ör. Gmail'i etkin bırakırken Drive erişimini kaldırma). Daha fazla bilgi

Yetersiz izinlerle ilgili sorunları giderme

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

  • Akışınızı yeniden yetkilendirin: Akışı Builder'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 talimatları 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ı açıklanmaktadır.

Adım adı Yapılandırma ve kapsam
Studio AI adımları
AIP temel öğeleri (Gemini'a sorun, Gem'e sorun, Gemini ile oluşturun, 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 3P
Kontrol edin: Yok - Dahili mantık
Listeyi filtreleme Yok - 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-posta 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 tepki 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
Chat alanına 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önder 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
Mesajı 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
E-tablo içeriğini al 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 bağlı olarak 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 Veri Kaybını Önleme dosya desteği için)
NotebookLM
NotebookLM'e kaynak ekleme https://www.googleapis.com/auth/drive.readonly
NotebookLM'e sorun https://www.googleapis.com/auth/drive.readonly