ตรวจสอบสิทธิ์และให้สิทธิ์แอป 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. เรียกใช้ 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 อื่นขณะประมวลผลการตอบกลับ

หากต้องการส่งข้อความแบบไม่พร้อมกันหรือทำงานในนามของผู้ใช้ แอปใน Chat จะส่งคำขอ 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 ดูแชทและส่งข้อความ

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

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

รหัสขอบเขต คำอธิบาย
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.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 APIs

ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขตสำหรับ 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 ของคุณ แอปแชทของคุณสามารถให้สิทธิ์ขอบเขตการให้สิทธิ์นี้ด้วยตนเองได้ โดยไม่จำเป็นต้องให้ผู้ดูแลระบบหรือผู้ใช้ปลายทางให้สิทธิ์
  • https://www.googleapis.com/auth/chat.app.* (ตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์): การใช้ขอบเขตเหล่านี้ต้องได้รับการอนุมัติจากผู้ดูแลระบบเป็นกรณีเฉพาะ ถึง คุณได้รับการอนุมัติจากผู้ดูแลระบบ เตรียมบัญชีบริการของแอป Chat เพื่อรับการอนุมัติจากผู้ดูแลระบบ โดยการสร้างไคลเอ็นต์ OAuth ที่ทำงานร่วมกับ Google Workspace Marketplace และ กำหนดค่าแอปใน SDK ของ Google Workspace Marketplace ขอบเขตเหล่านี้จะอนุญาตให้แอป 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
สื่อและ ไฟล์แนบ  
อัปโหลดสื่อเป็นไฟล์แนบ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ ให้ทำดังนี้
  • 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 — —
Callback ของ Apps Script — —
Google Cloud Pub/Sub — —
ตอบกลับข้อความ
แบบซิงโครนัส โดยใช้เหตุการณ์การโต้ตอบของแอป Chat — —
แบบซิงค์โดยใช้ค่าที่แสดงผลจากแคล็กแบ็กของ Apps Script — —
ส่งข้อความใหม่:
มีเว็บฮุคขาเข้า — —