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

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

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

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

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

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

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

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

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

  5. ส่งคำขออนุมัติสำหรับทรัพยากร: หากผู้ใช้ยินยอมที่จะปฏิบัติตาม ขอบเขตการให้สิทธิ์, App Bundle ของคุณและข้อมูลเข้าสู่ระบบ และที่ผู้ใช้อนุมัติ ขอบเขตลงในคำขอ ระบบจะส่งคำขอไปยังเซิร์ฟเวอร์การให้สิทธิ์ของ 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 อื่นในขณะที่ การประมวลผลคำตอบ

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

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

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

แอป Google 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.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.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

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

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

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

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

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

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

เมื่อใช้การให้สิทธิ์แอป แอป Chat จะเข้าถึง API ในรูปแบบแอปโดยใช้ข้อมูลเข้าสู่ระบบของบัญชีบริการ ให้สิทธิ์แอปเสมอ ใช้ขอบเขตการให้สิทธิ์ chat.bot

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

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

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

สำหรับการเรียก Chat API แบบไม่พร้อมกัน

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

วิธีการ รองรับการตรวจสอบสิทธิ์ผู้ใช้ รองรับการตรวจสอบสิทธิ์แอป รองรับขอบเขตการให้สิทธิ์
พื้นที่ทำงาน  
สร้างพื้นที่ทำงาน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.create
  • chat.spaces
  • chat.import
ตั้งค่าพื้นที่ทำงาน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.create
  • chat.spaces
เลือกพื้นที่ทำงาน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.readonly
  • chat.spaces
เมื่อใช้การตรวจสอบสิทธิ์แอป ให้ทำดังนี้
  • chat.bot
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ ให้ทำดังนี้
  • chat.admin.spaces.readonly
ระบุพื้นที่ทำงาน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.readonly
  • chat.spaces
เมื่อใช้การตรวจสอบสิทธิ์แอป ให้ทำดังนี้
  • chat.bot
ค้นหาพื้นที่ทำงาน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ ให้ทำดังนี้
  • chat.admin.spaces.readonly
อัปเดตพื้นที่ทำงาน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ ให้ทำดังนี้
  • chat.admin.spaces
ลบพื้นที่ทำงาน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.delete
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ ให้ทำดังนี้
  • chat.admin.delete
ดําเนินการนําเข้าสําหรับพื้นที่ทำงานให้เสร็จสมบูรณ์ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.import
ค้นหาข้อความส่วนตัว เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.spaces.readonly
  • chat.spaces
เมื่อใช้การตรวจสอบสิทธิ์แอป ให้ทำดังนี้
  • chat.bot
สมาชิก  
สร้างสมาชิก — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • chat.memberships
  • chat.memberships.app
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ ให้ทำดังนี้
  • chat.admin.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.memberships
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้โดยใช้สิทธิ์ของผู้ดูแลระบบ ให้ทำดังนี้
  • chat.admin.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.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
กิจกรรมใน 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 — —
แบบซิงโครนัส โดยใช้ค่าผลลัพธ์ Callback ของ Apps Script — —
ส่งข้อความใหม่:
มีเว็บฮุคขาเข้า — —