Saat Anda membangun dan menjalankan alur otomatis di Google Workspace Studio, keamanan dan privasi data sudah disertakan secara default. Workspace Studio menggunakan model identitas dengan hak istimewa terendah, yang berarti bahwa alur otomatis menjalankan tugas latar belakang hanya menggunakan izin minimum yang diperlukan untuk melakukan setiap tindakan, bukan memiliki akses luas dan tidak terbatas ke seluruh Akun Google pengguna.
Untuk mengonfigurasi otomatisasi Anda dengan aman dan mempertahankan visibilitas terkait cara data organisasi Anda diakses, gunakan panduan ini untuk mengidentifikasi izin yang diperlukan untuk setiap langkah dalam alur. Halaman ini menyediakan pemetaan setiap jenis langkah alur dan cakupan Open Authorization (OAuth) yang diperlukan.
Pengaruh cakupan OAuth terhadap penggunaan Studio Anda
Saat Anda menggunakan Workspace Studio, cakupan OAuth memengaruhi cara Anda membangun, menjalankan, dan mengelola alur dengan cara berikut:
- Otorisasi satu kali: Saat pertama kali menambahkan langkah yang berinteraksi dengan layanan Google (seperti Gmail atau Google Drive), Anda akan mendapatkan dialog login Google. Tindakan ini akan memberikan otorisasi cakupan tertentu untuk langkah tersebut sehingga alur dapat berjalan secara independen di latar belakang.
- Eksekusi latar belakang asinkron: Setelah diaktifkan, flow akan berjalan secara asinkron di infrastruktur Google. Alur ini menjalankan tugas (seperti menjadwalkan acara Kalender atau menulis draf) hanya menggunakan cakupan tertentu yang Anda setujui, bahkan saat Anda tidak login secara aktif.
- Pengawasan admin terpusat: Sebagai admin, Anda dapat melihat semua alur aktif di seluruh organisasi menggunakan setelan Pengelolaan Akses Agen di konsol Admin. Anda dapat menjeda alur tertentu atau menargetkan dan membatasi cakupan OAuth satu per satu (seperti menghapus akses Drive sambil membiarkan Gmail aktif) untuk menjaga keamanan data organisasi Anda. Pelajari lebih lanjut
Memecahkan masalah izin yang tidak memadai
Jika alur tidak berjalan dan menampilkan error "Izin Tidak Memadai" atau "Terjadi error" di Log Aktivitas, periksa hal berikut:
- Otorisasi ulang alur Anda: Buka alur di Builder, klik Simpan Perubahan, dan ikuti perintah di kotak otorisasi untuk memperbarui token OAuth yang sudah tidak berlaku atau tidak ada.
- Pemblokiran Akses Kontekstual (CAA): Jika organisasi Anda menerapkan kebijakan perangkat atau IP secara ketat, eksekusi alur latar belakang terkadang dapat diblokir. Pastikan Client ID Workspace Studio inti dikecualikan dari batasan CAA.
Langkah-langkah alur dan cakupan OAuth yang diperlukan
Tabel ini menguraikan langkah-langkah standar Workspace Studio dan cakupan OAuth yang diperlukan setiap langkah untuk dijalankan di balik layar.
| Nama langkah | Konfigurasi dan cakupan |
|---|---|
| Langkah-langkah AI Studio | |
| Primitif AIP (Minta Gemini, Minta Gem, Buat dengan Gemini, Deep Research, Ringkas email yang belum dibaca, Ekstrak, Putuskan, Ringkas) | 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 |
| Umum dan utilitas | |
| Sesuai jadwal | T/A |
| Mengirim webhook | T/A - Pihak Ketiga Eksternal |
| Periksa apakah | T/A - Logika internal |
| Memfilter daftar | T/A - Logika internal |
| Gmail | |
| Saat saya menerima email | https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger |
| Beri tahu saya melalui email | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly |
| Kirim email | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| Membuat draf email | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly |
| Meneruskan email | https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| Buat draf balasan | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| Membalas email | https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly |
| Menambahkan atau menghapus label | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Menandai sebagai telah atau belum dibaca | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Membintangi atau menghapus bintang | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Mengarsipkan (atau menghapus) | https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly |
| Google Chat | |
| Saat seseorang bergabung ke ruang | 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 |
| Saat saya menerima pesan chat | 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 |
| Saat saya disebut | 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 |
| Saat reaksi emoji ditambahkan | 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 |
| Beri tahu saya di 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 |
| Mengirim ruang chat | 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 |
| Kirim ke pengguna lain | 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 |
| Membalas pesan | 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 Spreadsheet | |
| Saat sheet diubah | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly |
| Menambahkan baris | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Memperbarui baris | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Kosongkan baris | https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Dapatkan isi sheet | https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Google Dokumen | |
| Membuat dokumen 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 |
| Tambahkan ke dokumen | https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly |
| Google Kalender dan Tasks | |
| Buat berdasarkan rapat | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly |
| Membuat tugas | https://www.googleapis.com/auth/tasks |
| Membuat acara | https://www.googleapis.com/auth/calendar.events |
| Menambahkan tamu | https://www.googleapis.com/auth/calendar.events |
| Google Drive | |
| Saat item ditambahkan ke folder | 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 |
| Saat file diedit | https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly |
| Saat item dalam folder diedit | 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 |
| Memindahkan file | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| Menyalin file | https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly |
| Menyimpan lampiran | 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 |
| Membuat folder | 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 | |
| Saat catatan rapat | 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 Formulir | |
| Saat respons formulir diterima | 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 (hanya untuk dukungan file DLP di Formulir) |
| NotebookLM | |
| Tambahkan Sumber ke NotebookLM | https://www.googleapis.com/auth/drive.readonly |
| Tanya NotebookLM | https://www.googleapis.com/auth/drive.readonly |