ขอบเขต OAuth และสิทธิ์สำหรับขั้นตอนโฟลว์ของ Workspace Studio

เมื่อคุณสร้างและเรียกใช้โฟลว์อัตโนมัติใน Google Workspace Studio ระบบจะรักษาความปลอดภัยและความเป็นส่วนตัวของข้อมูลโดยค่าเริ่มต้น Workspace Studio ใช้โมเดลข้อมูลประจำตัวที่มีสิทธิ์ขั้นต่ำที่สุด ซึ่งหมายความว่าโฟลว์อัตโนมัติจะเรียกใช้งานเบื้องหลังโดยใช้สิทธิ์ขั้นต่ำที่จำเป็นในการดำเนินการแต่ละอย่างเท่านั้น แทนที่จะมีสิทธิ์เข้าถึงบัญชี Google ทั้งหมดของผู้ใช้อย่างกว้างขวางและไม่จำกัด

หากต้องการกำหนดค่าการทำงานอัตโนมัติอย่างปลอดภัยและรักษาการเข้าถึงข้อมูลขององค์กรให้เป็นไปอย่างโปร่งใส โปรดใช้คู่มือนี้เพื่อระบุสิทธิ์ที่จำเป็นสำหรับแต่ละขั้นตอนในโฟลว์ หน้านี้แสดงการแมปประเภทขั้นตอนของโฟลว์แต่ละประเภทและขอบเขตการให้สิทธิ์แบบเปิด (OAuth) ที่จำเป็น

ขอบเขต OAuth ส่งผลต่อการใช้ Studio อย่างไร

เมื่อคุณใช้ Workspace Studio ขอบเขต OAuth จะส่งผลต่อวิธีสร้าง เรียกใช้ และจัดการโฟลว์ในลักษณะต่อไปนี้

  • การให้สิทธิ์แบบครั้งเดียว: ครั้งแรกที่คุณเพิ่มขั้นตอนที่โต้ตอบกับบริการของ Google (เช่น Gmail หรือ Google ไดรฟ์) คุณจะได้รับข้อความแจ้งให้ลงชื่อเข้าใช้ Google การดำเนินการนี้จะให้สิทธิ์ขอบเขตที่เฉพาะเจาะจงสำหรับขั้นตอนนั้นเพื่อให้โฟลว์ทำงานอย่างอิสระในเบื้องหลังได้
  • การดำเนินการแบบอะซิงโครนัสในเบื้องหลัง: หลังจากเปิดใช้โฟลว์แล้ว โฟลว์จะทำงานแบบอะซิงโครนัสในโครงสร้างพื้นฐานของ Google โฟลว์จะทำงานต่างๆ (เช่น การกำหนดเวลากิจกรรมในปฏิทินหรือการเขียนฉบับร่าง) โดยใช้เฉพาะขอบเขตที่คุณอนุมัติ แม้ว่าคุณจะไม่ได้ลงชื่อเข้าใช้อยู่ก็ตาม
  • การกำกับดูแลของผู้ดูแลระบบแบบรวมศูนย์: ในฐานะผู้ดูแลระบบ คุณสามารถดูขั้นตอนที่ใช้งานอยู่ทั้งหมดในองค์กรได้โดยใช้การตั้งค่าการจัดการการเข้าถึง Agent ในคอนโซลผู้ดูแลระบบ คุณสามารถหยุดโฟลว์บางรายการชั่วคราว หรือกำหนดเป้าหมายและจำกัดขอบเขต OAuth แต่ละรายการ (เช่น นำสิทธิ์เข้าถึงไดรฟ์ออกขณะที่ยังคงเปิดใช้งาน Gmail อยู่) เพื่อรักษาความปลอดภัยของข้อมูลขององค์กร ดูข้อมูลเพิ่มเติม

แก้ปัญหาสิทธิ์ไม่เพียงพอ

หากโฟลว์ไม่ทำงานและแสดงข้อผิดพลาด "สิทธิ์ไม่เพียงพอ" หรือ "เกิดข้อผิดพลาด" ในบันทึกกิจกรรม ให้ตรวจสอบสิ่งต่อไปนี้

  • ให้สิทธิ์โฟลว์อีกครั้ง: เปิดโฟลว์ในเครื่องมือสร้าง คลิกบันทึกการเปลี่ยนแปลง แล้วทำตามข้อความแจ้งในช่องการให้สิทธิ์เพื่อรีเฟรชโทเค็น OAuth ที่หมดอายุหรือขาดหายไป
  • การบล็อกการเข้าถึงแบบ Context-Aware (CAA): หากองค์กรบังคับใช้นโยบายอุปกรณ์หรือ IP อย่างเคร่งครัด บางครั้งการดำเนินการโฟลว์ในเบื้องหลังอาจถูกบล็อก ตรวจสอบว่ารหัสไคลเอ็นต์ Workspace Studio หลักได้รับการยกเว้นจากข้อจำกัด CAA

ขั้นตอนของโฟลว์และขอบเขต OAuth ที่จำเป็น

ตารางนี้แสดงขั้นตอนมาตรฐานของ Workspace Studio และขอบเขต OAuth ที่แต่ละขั้นตอนต้องใช้เพื่อทำงานเบื้องหลัง

ชื่อขั้นตอน การกำหนดค่าและขอบเขต
ขั้นตอน AI ของ Studio
AIP Primitives (ขอความช่วยเหลือจาก Gemini, ถาม Gem, สร้างด้วย Gemini, Deep Research, สรุปอีเมลที่ยังไม่อ่าน, ดึงข้อมูล, ตัดสินใจ, สรุป) 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
ทั่วไปและยูทิลิตี
ตามกำหนดเวลา ไม่มี
ส่งเว็บฮุค ไม่มี - บุคคลที่สามภายนอก
ตรวจสอบว่า ไม่มี - ตรรกะภายใน
กรองรายการ ไม่มี - ตรรกะภายใน
Gmail
เมื่อได้รับอีเมล https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.event_trigger https://www.googleapis.com/auth/workspace.workflows.trigger 
แจ้งเตือนฉันทางอีเมล https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
ส่งอีเมล https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
ร่างอีเมล https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.readonly
ส่งต่ออีเมล https://www.googleapis.com/auth/gmail.send https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
ร่างการตอบกลับ https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
ตอบกลับอีเมล https://www.googleapis.com/auth/gmail.compose https://www.googleapis.com/auth/gmail.readonly
เพิ่มหรือนำป้ายกำกับออก https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
ทำเครื่องหมายว่าอ่านแล้วหรือยังไม่อ่าน https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
ติดดาวหรือยกเลิกการติดดาว https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
เก็บ (หรือลบ) https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/gmail.readonly
Google 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
เมื่อได้รับข้อความแชท 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
เมื่อมีคนพูดถึงฉัน 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
เมื่อเพิ่มรีแอ็กชันด้วยอีโมจิ 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 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 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
ส่งให้คนอื่น 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
ตอบกลับข้อความ 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 ชีต
เมื่อชีตมีการเปลี่ยนแปลง https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly
เพิ่มแถว https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
อัปเดตแถว https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
ล้างแถว https://www.googleapis.com/auth/spreadsheet https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
รับเนื้อหาของชีต https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
Google เอกสาร
สร้างเอกสารใน 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
เพิ่มลงในเอกสาร https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/documents https://www.googleapis.com/auth/drive.readonly
Google ปฏิทินและ Tasks
อิงตามการประชุม https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/calendar.events.readonly 
สร้างงาน https://www.googleapis.com/auth/tasks
สร้างกิจกรรม https://www.googleapis.com/auth/calendar.events
เพิ่มผู้เข้าร่วม https://www.googleapis.com/auth/calendar.events
Google ไดรฟ์
เมื่อเพิ่มรายการลงในโฟลเดอร์ 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
เมื่อมีการแก้ไขไฟล์ https://www.googleapis.com/auth/workspace.workflows.trigger https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly
เมื่อมีการแก้ไขรายการในโฟลเดอร์ 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
ย้ายไฟล์ https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
คัดลอกไฟล์ https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.readonly
บันทึกไฟล์แนบ 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
สร้างโฟลเดอร์ 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
เมื่อบันทึกการประชุม 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 ฟอร์ม
เมื่อมีการส่งการตอบกลับแบบฟอร์ม 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 (สำหรับการรองรับไฟล์ DLP ในฟอร์มเท่านั้น)
NotebookLM
เพิ่มแหล่งข้อมูลไปยัง NotebookLM https://www.googleapis.com/auth/drive.readonly
ถาม NotebookLM https://www.googleapis.com/auth/drive.readonly