ตรวจสอบสิทธิ์และให้สิทธิ์แอป Chat และคำขอ Google Chat API

การตรวจสอบสิทธิ์และการให้สิทธิ์เป็นกลไกที่ใช้ในการยืนยันตัวตนและการเข้าถึงทรัพยากรตามลำดับ เอกสารนี้จะอธิบายวิธีการทำงานของการตรวจสอบสิทธิ์และการให้สิทธิ์สำหรับแอป Chat และคำขอ Chat API

ภาพรวมของกระบวนการ

แผนภาพต่อไปนี้แสดงขั้นตอนระดับสูงของการตรวจสอบสิทธิ์และการให้สิทธิ์สำหรับ Google Chat

ขั้นตอนระดับสูงสำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ Google Chat
รูปที่ 1 ขั้นตอนระดับสูงสำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ Google Chat

  1. กำหนดค่าโปรเจ็กต์ Google Cloud, เปิดใช้ Chat API และกำหนดค่าแอป Chat: ในระหว่างการพัฒนา คุณสร้างโปรเจ็กต์ Google Cloud ในโปรเจ็กต์ Google Cloud คุณจะเปิดใช้ Chat API, กำหนดค่าแอป Chat และตั้งค่าการตรวจสอบสิทธิ์ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อพัฒนาใน Google Workspace และหัวข้อสร้างแอป Chat

  2. Call Chat API: เมื่อแอปเรียกใช้ Chat API แอปจะส่งข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ไปยัง Chat API หากแอปตรวจสอบสิทธิ์ด้วยบัญชีบริการ ระบบจะส่งข้อมูลเข้าสู่ระบบเป็นส่วนหนึ่งของโค้ดของแอป หากแอปของคุณต้องใช้การเรียกใช้ Chat API โดยใช้การตรวจสอบสิทธิ์ของผู้ใช้ที่ยังไม่ได้รับสิทธิ์ ระบบจะแจ้งให้ผู้ใช้ลงชื่อเข้าใช้

  3. ขอทรัพยากร: แอปขอสิทธิ์เข้าถึงด้วยขอบเขตที่คุณระบุไว้ขณะตั้งค่าการตรวจสอบสิทธิ์

  4. ขอความยินยอม: หากแอปตรวจสอบสิทธิ์ในฐานะผู้ใช้ Google จะแสดงหน้าจอขอความยินยอม OAuth เพื่อให้ผู้ใช้ตัดสินใจได้ว่าจะให้สิทธิ์แอปของคุณในการเข้าถึงข้อมูลที่ขอหรือไม่ การตรวจสอบสิทธิ์ด้วยบัญชีบริการไม่จำเป็นต้องได้รับความยินยอมจากผู้ใช้

  5. ส่งคําขอทรัพยากรที่ได้รับอนุมัติ: หากผู้ใช้ให้ความยินยอมสําหรับขอบเขตการให้สิทธิ์ แอปจะรวมข้อมูลเข้าสู่ระบบและขอบเขตที่ผู้ใช้อนุมัติไว้ในคําขอ ระบบจะส่งคําขอไปยังเซิร์ฟเวอร์การให้สิทธิ์ของ Google เพื่อรับโทเค็นการเข้าถึง

  6. Google ส่งคืนโทเค็นการเข้าถึง: โทเค็นเพื่อการเข้าถึงมีรายการขอบเขตที่ได้รับสิทธิ์ หากรายการขอบเขตที่แสดงผลจํากัดมากกว่าขอบเขตที่ขอ แอปจะปิดฟีเจอร์ที่จำกัดโดยโทเค็น

  7. ทรัพยากรที่ขอการเข้าถึง: แอปของคุณใช้โทเค็นเพื่อการเข้าถึงจาก Google เพื่อเรียกใช้ Chat API และเข้าถึงทรัพยากรของ Chat API

  8. รับโทเค็นการรีเฟรช (ไม่บังคับ): หากแอปต้องเข้าถึง Google Chat API เกินอายุการใช้งานของโทเค็นเพื่อการเข้าถึงรายการเดียว แอปอาจรับโทเค็นการรีเฟรช ดูข้อมูลเพิ่มเติมได้ที่หัวข้อใช้ OAuth 2.0 เพื่อเข้าถึง Google API

  9. ขอทรัพยากรเพิ่มเติม: หากแอปต้องการสิทธิ์เข้าถึงเพิ่มเติม แอปจะขอให้ผู้ใช้มอบสิทธิ์ขอบเขตใหม่ ซึ่งจะส่งผลให้มีคำขอใหม่เพื่อรับโทเค็นการเข้าถึง (ขั้นตอนที่ 3-6)

เมื่อแอปใน Chat กำหนดให้ตรวจสอบสิทธิ์

แอปแชทสามารถส่งข้อความเพื่อตอบสนองต่อการโต้ตอบของผู้ใช้ หรือส่งแบบไม่เป็นไปพร้อมกัน นอกจากนี้ ผู้ใช้ยังทำงานให้เสร็จสมบูรณ์ในนามของผู้ใช้ได้ด้วย เช่น สร้างพื้นที่ใน Chat หรือดูรายชื่อบุคคลในพื้นที่ใน Chat

แอปใน Chat ไม่จำเป็นต้องมีการตรวจสอบสิทธิ์เพื่อตอบสนองต่อการโต้ตอบของผู้ใช้ เว้นแต่ว่าแอปใน Chat จะเรียกใช้ Chat API หรือ Google API อื่นขณะประมวลผลการตอบกลับ

หากต้องการส่งข้อความแบบไม่พร้อมกันหรือทำงานในนามของผู้ใช้ แอปใน Chat จะส่งคำขอ RESTful ไปยัง Chat API ซึ่งต้องมีการตรวจสอบสิทธิ์และให้สิทธิ์

การตอบกลับการโต้ตอบของผู้ใช้ไม่ต้องมีการตรวจสอบสิทธิ์

แอป Google Chat ไม่จำเป็นต้องตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือแอป Chat เพื่อรับและตอบกลับเหตุการณ์การโต้ตอบแบบพร้อมกัน

แอป Google Chat จะได้รับเหตุการณ์การโต้ตอบทุกครั้งที่ผู้ใช้โต้ตอบหรือเรียกใช้แอป Chat ซึ่งรวมถึงเหตุการณ์ต่อไปนี้

  • ผู้ใช้ส่งข้อความไปยังแอป Chat
  • ผู้ใช้ @พูดถึงแอปใน Chat
  • ผู้ใช้เรียกใช้คําสั่งเครื่องหมายทับรายการใดรายการหนึ่งของแอป Chat

แผนภาพต่อไปนี้แสดงลำดับการส่งคำขอและการตอบกลับระหว่างผู้ใช้ Chat กับแอป Chat

ไม่ต้องมีการให้สิทธิ์สำหรับเหตุการณ์การโต้ตอบในแอป Chat
ภาพที่ 2 เหตุการณ์การโต้ตอบในแอป Chat ไม่ต้องมีการตรวจสอบสิทธิ์

  1. ผู้ใช้ส่งข้อความไปยังแอป Chat ใน Google Chat
  2. Google Chat จะส่งต่อข้อความไปยังแอป
  3. แอปจะรับข้อความ ประมวลผล และส่งการตอบกลับไปยัง Google Chat
  4. Google Chat จะแสดงผลคำตอบสําหรับผู้ใช้หรือในพื้นที่ทำงาน

ลำดับนี้จะเกิดซ้ำสำหรับเหตุการณ์การโต้ตอบของแอป Chat แต่ละเหตุการณ์

ข้อความแบบไม่พร้อมกันต้องมีการตรวจสอบสิทธิ์

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

เมื่อเรียกใช้ Chat API แอป Chat จะโพสต์ข้อความไปยัง Google Chat หรือทำงานต่างๆ และเข้าถึงข้อมูลในนามของผู้ใช้ได้ ตัวอย่างเช่น หลังจากตรวจพบเซิร์ฟเวอร์หยุดทำงาน แอป Chat สามารถเรียกใช้ Chat API เพื่อทำสิ่งต่อไปนี้

  • สร้างพื้นที่ใน Chat เพื่อตรวจสอบและแก้ไขปัญหาการหยุดทำงานโดยเฉพาะ
  • เพิ่มบุคคลในพื้นที่ทำงานของ Chat
  • โพสต์ข้อความไปยังพื้นที่ใน Chat เพื่อแจ้งรายละเอียดเกี่ยวกับการหยุดทำงาน

แผนภาพต่อไปนี้แสดงลำดับของข้อความแบบไม่พร้อมกันระหว่างแอป Chat และพื้นที่ใน Chat

ต้องมีการตรวจสอบสิทธิ์สำหรับข้อความแบบอะซิงโครนัส
ภาพที่ 3 ข้อความแบบไม่พร้อมกันต้องมีการตรวจสอบสิทธิ์

  1. แอป Chat สร้างข้อความโดยการเรียกใช้ Chat API โดยใช้spaces.messages.createวิธี และใส่ข้อมูลเข้าสู่ระบบของผู้ใช้ไว้ในคำขอ HTTP
  2. Google Chat จะตรวจสอบสิทธิ์แอป Chat ด้วยบัญชีบริการหรือข้อมูลเข้าสู่ระบบของผู้ใช้
  3. Google Chat จะแสดงผลข้อความของแอปในพื้นที่ใน Chat ที่ระบุ

ขอบเขตของ Chat API

กำหนดค่าหน้าจอขอความยินยอม OAuth และเลือกขอบเขตเพื่อกำหนดข้อมูลที่แสดงต่อผู้ใช้และผู้ตรวจสอบแอป และลงทะเบียนแอปเพื่อให้เผยแพร่ได้ในภายหลัง

หากต้องการกำหนดระดับการเข้าถึงที่อนุญาตแก่แอป คุณต้องระบุและประกาศขอบเขตการให้สิทธิ์ ขอบเขตการให้สิทธิ์คือสตริง URI ของ OAuth 2.0 ที่มีชื่อแอป Google Workspace, ประเภทข้อมูลที่แอปเข้าถึง และระดับการเข้าถึง

ขอบเขตที่ไม่มีความละเอียดอ่อน

รหัสขอบเขต คำอธิบาย
https://www.googleapis.com/auth/chat.bot

อนุญาตให้แอป Chat ดูแชทและส่งข้อความ

ขอบเขตนี้รองรับเฉพาะการตรวจสอบสิทธิ์ของแอปด้วยบัญชีบริการ คุณไม่สามารถตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ใช้หรือการมอบสิทธิ์ทั่วทั้งโดเมนโดยใช้ขอบเขตนี้

ขอบเขตที่ละเอียดอ่อน

รหัสขอบเขต คำอธิบาย
https://www.googleapis.com/auth/chat.spaces สร้างการสนทนาและพื้นที่ทำงาน ตลอดจนดูหรือแก้ไขข้อมูลเมตา (รวมถึงการตั้งค่าประวัติและการตั้งค่าการเข้าถึง) ใน Chat
https://www.googleapis.com/auth/chat.spaces.create สร้างการสนทนาใหม่ใน Chat
https://www.googleapis.com/auth/chat.spaces.readonly ดูแชทและพื้นที่ทำงานใน Chat
https://www.googleapis.com/auth/chat.memberships ดู เพิ่ม อัปเดต และนำสมาชิกออกจากการสนทนาใน Chat
https://www.googleapis.com/auth/chat.memberships.app เพิ่มและนำตัวเองออกจากการสนทนาใน Google Chat
https://www.googleapis.com/auth/chat.memberships.readonly ดูสมาชิกในการสนทนาของ Chat
https://www.googleapis.com/auth/chat.messages.create เขียนและส่งข้อความใน Chat
https://www.googleapis.com/auth/chat.messages.reactions ดู เพิ่ม และลบความรู้สึกที่มีต่อข้อความใน Chat
https://www.googleapis.com/auth/chat.messages.reactions.create เพิ่มความรู้สึกที่มีต่อข้อความใน Chat
https://www.googleapis.com/auth/chat.messages.reactions.readonly ดูความรู้สึกที่มีต่อข้อความใน Chat
https://www.googleapis.com/auth/chat.users.readstate ดูและแก้ไขเวลาที่อ่านล่าสุดสำหรับการสนทนาใน Chat
https://www.googleapis.com/auth/chat.users.readstate.readonly ดูเวลาที่อ่านล่าสุดของการสนทนาใน Chat
https://www.googleapis.com/auth/chat.admin.spaces.readonly ดูแชทและพื้นที่ทำงานที่เป็นของโดเมนของผู้ดูแลระบบใน Chat
https://www.googleapis.com/auth/chat.admin.spaces ดูหรือแก้ไขแชทและพื้นที่ทำงานที่เป็นของโดเมนของผู้ดูแลระบบใน Chat
https://www.googleapis.com/auth/chat.admin.memberships.readonly ดูสมาชิกและผู้จัดการในการสนทนาที่เป็นของโดเมนของผู้ดูแลระบบใน Chat
https://www.googleapis.com/auth/chat.admin.memberships ดู เพิ่ม อัปเดต และนำสมาชิกและผู้จัดการออกจากการสนทนาของโดเมนผู้ดูแลระบบใน Chat
https://www.googleapis.com/auth/chat.app.spaces

สร้างการสนทนาและพื้นที่ทำงาน ตลอดจนดูหรืออัปเดตข้อมูลเมตา (รวมถึงการตั้งค่าประวัติและการตั้งค่าการเข้าถึง) ใน Chat ต้องได้รับอนุมัติจากผู้ดูแลระบบ

ขอบเขตนี้รองรับเฉพาะการตรวจสอบสิทธิ์แอปด้วยบัญชีบริการ คุณไม่สามารถตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ใช้หรือการมอบสิทธิ์ทั่วทั้งโดเมนโดยใช้ขอบเขตนี้
https://www.googleapis.com/auth/chat.app.spaces.create

สร้างการสนทนาและพื้นที่ทำงานใหม่ใน Chat ต้องอนุมัติจากผู้ดูแลระบบ

ขอบเขตนี้รองรับเฉพาะการตรวจสอบสิทธิ์แอปด้วยบัญชีบริการ คุณไม่สามารถตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ใช้หรือการมอบสิทธิ์ทั่วทั้งโดเมนโดยใช้ขอบเขตนี้
https://www.googleapis.com/auth/chat.app.memberships

ดู เพิ่ม อัปเดต และนำสมาชิกออกจากการสนทนาและพื้นที่ทำงานใน Chat ต้องอนุมัติจากผู้ดูแลระบบ

ขอบเขตนี้รองรับเฉพาะการตรวจสอบสิทธิ์แอปด้วยบัญชีบริการ คุณไม่สามารถตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ใช้หรือการมอบสิทธิ์ทั่วทั้งโดเมนโดยใช้ขอบเขตนี้
https://www.googleapis.com/auth/chat.customemojis ดู สร้าง และลบอีโมจิที่กำหนดเองใน Chat
https://www.googleapis.com/auth/chat.customemojis.readonly ดูอีโมจิที่กำหนดเองใน Chat
https://www.googleapis.com/auth/chat.users.spacesettings ดูและอัปเดตการตั้งค่าพื้นที่ของผู้ใช้ Chat

ดู API การตั้งค่าผู้ใช้พื้นที่ทำงาน: getSpaceNotificationSetting, updateSpaceNotificationSetting

ขอบเขตที่จํากัด

รหัสขอบเขต คำอธิบาย
https://www.googleapis.com/auth/chat.delete ลบการสนทนาและพื้นที่ทำงาน รวมถึงยกเลิกสิทธิ์เข้าถึงไฟล์ที่เกี่ยวข้องใน Chat
https://www.googleapis.com/auth/chat.import นําเข้าพื้นที่ ข้อความ และการเป็นสมาชิกไปยัง Chat โปรดดูข้อมูลเพิ่มเติมที่หัวข้อให้สิทธิ์แอปใน Chat ในการนำเข้าข้อมูล
https://www.googleapis.com/auth/chat.messages ดู เขียน ส่ง อัปเดต และลบข้อความ รวมถึงเพิ่ม ดู และลบความรู้สึกที่มีต่อข้อความ
https://www.googleapis.com/auth/chat.messages.readonly ดูข้อความและความรู้สึกใน Chat
https://www.googleapis.com/auth/chat.admin.delete ลบการสนทนาและพื้นที่ทำงานที่โดเมนของผู้ดูแลระบบเป็นเจ้าของ และนำสิทธิ์เข้าถึงไฟล์ที่เกี่ยวข้องใน Chat ออก
https://www.googleapis.com/auth/chat.app.delete

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

ขอบเขตนี้รองรับเฉพาะการตรวจสอบสิทธิ์แอปด้วยบัญชีบริการ คุณไม่สามารถตรวจสอบสิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ใช้หรือการมอบสิทธิ์ทั่วทั้งโดเมนโดยใช้ขอบเขตนี้

ขอบเขตในตารางก่อนหน้านี้ระบุความละเอียดอ่อนตามคำจำกัดความต่อไปนี้

หากแอปของคุณต้องมีสิทธิ์เข้าถึง API อื่นๆ ของ Google คุณก็เพิ่มขอบเขตเหล่านั้นได้เช่นกัน สำหรับข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต Google API โปรดดูการใช้ OAuth 2.0 เพื่อเข้าถึง Google API

ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขตสำหรับ Google Workspace API ได้ที่กำหนดค่าหน้าจอขอความยินยอม OAuth และเลือกขอบเขต

ประเภทของการตรวจสอบสิทธิ์ที่จำเป็น

แอปใน Chat ตรวจสอบสิทธิ์และให้สิทธิ์กับ Chat API ได้ 2 วิธีดังนี้

การตรวจสอบสิทธิ์ผู้ใช้
การตรวจสอบสิทธิ์ของผู้ใช้ ช่วยให้แอป Chat เข้าถึงข้อมูลผู้ใช้และดำเนินการต่างๆ ในนามของผู้ใช้ ขอบเขต OAuth จะระบุข้อมูลและการดําเนินการที่อนุญาต เว้นแต่แอป Chat จะติดตั้งโดยผู้ดูแลระบบหรือได้รับการมอบสิทธิ์ทั่วทั้งโดเมน ในครั้งแรกที่แอป Chat ดำเนินการในนามของผู้ใช้ ผู้ใช้ต้องให้สิทธิ์แอป Chat โดยใช้หน้าจอขอความยินยอม OAuth
การตรวจสอบสิทธิ์แอป

การตรวจสอบสิทธิ์แอปช่วยให้แอป Chat ใช้ข้อมูลเข้าสู่ระบบของบัญชีบริการ รวมถึงเข้าถึงข้อมูลและดำเนินการต่างๆ ในฐานะตัวแอปเองได้ เนื่องจากแอป Chat ใช้ข้อมูลเข้าสู่ระบบของตนเองเพื่อเข้าถึงและทำงานกับทรัพยากร ผู้ใช้ปลายทางจึงไม่จำเป็นต้องอนุมัติการเรียก API ของแอป Chat และคุณจะไม่สามารถเพิ่มขอบเขตการให้สิทธิ์ OAuth ที่รองรับการให้สิทธิ์แอปในหน้าจอคำยินยอม OAuth ได้

ขอบเขตการให้สิทธิ์ OAuth 2 ประเภทรองรับการตรวจสอบสิทธิ์แอป ดังนี้

  • https://www.googleapis.com/auth/chat.bot: แอปใน Chat จะเรียกใช้เมธอด Google Chat API ที่รองรับขอบเขตการให้สิทธิ์นี้เพื่อสร้าง อัปเดต รับ แสดงรายการ หรือลบทรัพยากรที่แอปมีสิทธิ์เข้าถึงได้ เช่น ข้อความในพื้นที่ทำงานที่ผู้ใช้ปลายทางเพิ่มแอป Chat ของคุณ แอป Chat สามารถให้สิทธิ์ขอบเขตการให้สิทธิ์นี้ด้วยตนเองได้โดยไม่ต้องให้สิทธิ์ผู้ดูแลระบบหรือผู้ใช้ปลายทาง
  • https://www.googleapis.com/auth/chat.app.* (ตัวอย่างสำหรับนักพัฒนาแอป): การใช้ขอบเขตเหล่านี้ต้องได้รับอนุมัติจากผู้ดูแลระบบเป็นกรณีเฉพาะ หากต้องการได้รับการอนุมัติจากผู้ดูแลระบบ ให้เตรียมบัญชีบริการของแอป Chat เพื่อรับการอนุมัติจากผู้ดูแลระบบโดยการสร้างไคลเอ็นต์ OAuth ที่เข้ากันได้กับ Google Workspace Marketplace และกำหนดค่าแอปใน Google Workspace Marketplace SDK ขอบเขตเหล่านี้จะอนุญาตให้แอป Chat เรียกใช้เมธอด Google Chat API ที่เฉพาะเจาะจง เช่น chat.app.spaces.create อนุญาตให้แอปสร้างพื้นที่ทำงานใน Chat

หากวิธีใดรองรับการตรวจสอบสิทธิ์ทั้งของผู้ใช้หรือแอป Chat API จะแสดงผลแตกต่างกันตามประเภทการตรวจสอบสิทธิ์ที่คุณใช้ ดังนี้

  • เมื่อใช้การตรวจสอบสิทธิ์แอป เมธอดจะแสดงเฉพาะทรัพยากรที่แอป Chat เข้าถึงได้เท่านั้น
  • เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ เมธอดจะแสดงเฉพาะทรัพยากรที่ผู้ใช้เข้าถึงได้เท่านั้น

เช่น การเรียกใช้เมธอด spaces.list() ที่มีการให้สิทธิ์แอปจะแสดงรายการพื้นที่ทำงานที่แอป Chat เป็นสมาชิก การเรียกใช้ spaces.list() ด้วยการให้สิทธิ์ผู้ใช้จะแสดงรายการพื้นที่ทำงานที่ผู้ใช้เป็นสมาชิก ในทางปฏิบัติ คุณอาจใช้การตรวจสอบสิทธิ์ทั้ง 2 ประเภทเมื่อเรียกใช้ Chat API ทั้งนี้ขึ้นอยู่กับการออกแบบและฟีเจอร์ของแอป Chat

สําหรับการเรียก Chat API แบบอะซิงโครนัส

ตารางต่อไปนี้แสดงเมธอดของ Chat API และขอบเขตการให้สิทธิ์ที่รองรับ

วิธีการ รองรับการตรวจสอบสิทธิ์ผู้ใช้ รองรับการตรวจสอบสิทธิ์แอป รองรับขอบเขตการให้สิทธิ์
พื้นที่ทำงาน  
สร้างพื้นที่ทำงาน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.create
  • chat.spaces
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์แอปและการอนุมัติจากผู้ดูแลระบบ (มีให้ใช้งานในตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์) ให้ทำดังนี้
  • chat.app.spaces.create
  • chat.app.spaces
ตั้งค่าพื้นที่ทำงาน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.create
  • chat.spaces
เลือกพื้นที่ทำงาน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.readonly
  • chat.spaces
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ
  • chat.admin.spaces.readonly
เมื่อใช้การตรวจสอบสิทธิ์ของแอป ให้ทำดังนี้
  • chat.bot
เมื่อมีการตรวจสอบสิทธิ์ของแอปและการอนุมัติของผู้ดูแลระบบ (มีให้บริการในเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอป) จะมีการดำเนินการต่อไปนี้
  • chat.app.spaces
แสดงรายการพื้นที่ทำงาน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.readonly
  • chat.spaces
เมื่อใช้การตรวจสอบสิทธิ์แอป
  • chat.bot
ค้นหาพื้นที่ทำงาน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ ให้ทำดังนี้
  • chat.admin.spaces.readonly
อัปเดตพื้นที่ทำงาน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ
  • chat.admin.spaces
เมื่อมีการตรวจสอบสิทธิ์ของแอปและการอนุมัติของผู้ดูแลระบบ (มีให้บริการในเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอป) จะมีการดำเนินการต่อไปนี้
  • chat.app.spaces
ลบพื้นที่ทำงาน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.delete
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ จะมีการดำเนินการต่อไปนี้
  • chat.admin.delete
เมื่อใช้การตรวจสอบสิทธิ์แอปและการอนุมัติจากผู้ดูแลระบบ (มีให้ใช้งานในตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์) ให้ทำดังนี้
  • chat.app.delete
ดําเนินการนําเข้าสําหรับพื้นที่ทํางานให้เสร็จสมบูรณ์ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.import
ค้นหาข้อความส่วนตัว เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.readonly
  • chat.spaces
เมื่อใช้การตรวจสอบสิทธิ์ของแอป ให้ทำดังนี้
  • chat.bot
สมาชิก  
สร้างสมาชิก เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.memberships
  • chat.memberships.app
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ จะมีการดำเนินการต่อไปนี้
  • chat.admin.memberships
เมื่อมีการตรวจสอบสิทธิ์ของแอปและการอนุมัติของผู้ดูแลระบบ (มีให้บริการในเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอป) จะมีการดำเนินการต่อไปนี้
  • chat.app.memberships
รับสมาชิก เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.memberships.readonly
  • chat.memberships
เมื่อใช้การตรวจสอบสิทธิ์แอป
  • chat.bot
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ จะมีการดำเนินการต่อไปนี้
  • chat.admin.memberships.readonly
แสดงสมาชิก เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.memberships.readonly
  • chat.memberships
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ของแอป ให้ทำดังนี้
  • chat.bot
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ จะมีการดำเนินการต่อไปนี้
  • chat.admin.memberships.readonly
ลบสมาชิก เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.memberships
  • chat.memberships.app
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ จะมีการดำเนินการต่อไปนี้
  • chat.admin.memberships
เมื่อมีการตรวจสอบสิทธิ์ของแอปและการอนุมัติของผู้ดูแลระบบ (มีให้บริการในเวอร์ชันตัวอย่างสำหรับนักพัฒนาแอป) จะมีการดำเนินการต่อไปนี้
  • chat.app.memberships
อัปเดตสมาชิก เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.memberships
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ
  • chat.admin.memberships
เมื่อใช้การตรวจสอบสิทธิ์แอปและการอนุมัติจากผู้ดูแลระบบ (มีให้ใช้งานในตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์) ให้ทำดังนี้
  • chat.app.memberships
ข้อความ  
สร้างข้อความ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages.create
  • chat.messages
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ของแอป ให้ทำดังนี้
  • chat.bot
รับข้อความ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages.readonly
  • chat.messages
เมื่อใช้การตรวจสอบสิทธิ์แอป
  • chat.bot
แสดงข้อความ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages.readonly
  • chat.messages
  • chat.import
อัปเดตข้อความ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ของแอป ให้ทำดังนี้
  • chat.bot
ลบข้อความ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ของแอป ให้ทำดังนี้
  • chat.bot
รีแอ็กชัน  
สร้างรีแอ็กชัน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages.reactions.create
  • chat.messages.reactions
  • chat.messages
  • chat.import
แสดงรีแอ็กชัน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages.reactions.readonly
  • chat.messages.reactions
  • chat.messages.readonly
  • chat.messages
ลบรีแอ็กชัน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages.reactions
  • chat.messages
  • chat.import
อีโมจิที่กำหนดเอง  
สร้างอีโมจิที่กำหนดเอง — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.customemojis
ลบอีโมจิที่กำหนดเอง — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.customemojis
รับอีโมจิที่กำหนดเอง — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.customemojis
  • chat.customemojis.readonly
แสดงรายการอีโมจิที่กำหนดเอง — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.customemojis
  • chat.customemojis.readonly
สื่อและไฟล์แนบ  
อัปโหลดสื่อเป็นไฟล์แนบ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages.create
  • chat.messages
  • chat.import
ดาวน์โหลดสื่อ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.messages.readonly
  • chat.messages
เมื่อใช้การตรวจสอบสิทธิ์แอป
  • chat.bot
รับไฟล์แนบของข้อความ — เมื่อใช้การตรวจสอบสิทธิ์แอป ให้ทำดังนี้
  • chat.bot
สถานะการอ่านของผู้ใช้
รับสถานะการอ่านพื้นที่ทำงานของผู้ใช้ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.users.readstate
  • chat.users.readstate.readonly
อัปเดตสถานะการอ่านพื้นที่ทำงานของผู้ใช้ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.users.readstate
รับสถานะการอ่านชุดข้อความของผู้ใช้ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.users.readstate
  • chat.users.readstate.readonly
การตั้งค่าพื้นที่ทำงานของผู้ใช้
รับการตั้งค่าการแจ้งเตือนในพื้นที่ทำงานของผู้ใช้ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.users.spacesettings
อัปเดตการตั้งค่าการแจ้งเตือนพื้นที่ของผู้ใช้ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.users.spacesettings
กิจกรรมใน Space
รับเหตุการณ์ของพื้นที่ทำงาน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณต้องใช้ขอบเขตตาม ประเภทเหตุการณ์ ดังนี้
  • สำหรับเหตุการณ์เกี่ยวกับข้อความ ให้ทำดังนี้
    • chat.messages
    • chat.messages.readonly
  • สำหรับเหตุการณ์เกี่ยวกับความรู้สึก
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • สำหรับกิจกรรมเกี่ยวกับการเป็นสมาชิก
    • chat.memberships
    • chat.memberships.readonly
  • สำหรับกิจกรรมเกี่ยวกับพื้นที่ทำงาน ให้ทำดังนี้
    • chat.spaces
    • chat.spaces.readonly
แสดงรายการเหตุการณ์ในพื้นที่ทำงาน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณต้องใช้ขอบเขตสำหรับ เหตุการณ์แต่ละประเภทที่รวมอยู่ในคำขอ ดังนี้
  • สําหรับเหตุการณ์เกี่ยวกับข้อความ ให้ทำดังนี้
    • chat.messages
    • chat.messages.readonly
  • สำหรับเหตุการณ์เกี่ยวกับความรู้สึก
    • chat.messages.reactions
    • chat.messages.reactions.readonly
    • chat.messages
    • chat.messages.readonly
  • สำหรับกิจกรรมเกี่ยวกับการเป็นสมาชิก
    • chat.memberships
    • chat.memberships.readonly
  • สำหรับกิจกรรมเกี่ยวกับพื้นที่ทำงาน ให้ทำดังนี้
    • chat.spaces
    • chat.spaces.readonly

สําหรับเหตุการณ์การโต้ตอบในแอป Chat

ตารางต่อไปนี้แสดงวิธีทั่วไปที่ผู้ใช้โต้ตอบกับแอปใน Chat รวมทั้งข้อมูลว่าจำเป็นต้องมีหรือรองรับการตรวจสอบสิทธิ์หรือไม่

สถานการณ์ ไม่ต้องมีการตรวจสอบสิทธิ์ รองรับการตรวจสอบสิทธิ์ผู้ใช้ รองรับการตรวจสอบสิทธิ์แอป
รับข้อความจาก:
เหตุการณ์การโต้ตอบในแอป Chat — —
Callback ของ Apps Script — —
Google Cloud Pub/Sub — —
ตอบกลับข้อความ
แบบซิงค์โดยใช้เหตุการณ์การโต้ตอบกับแอป Chat — —
แบบซิงค์โดยใช้ค่าที่แสดงผลจากแคล็กแบ็กของ Apps Script — —
ส่งข้อความใหม่:
ใช้เว็บฮุคขาเข้า — —