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

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

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

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

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

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

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

  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 ในฐานะแอปใน Chat ต้องได้รับการอนุมัติจากผู้ดูแลระบบ

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

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

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

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

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

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

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

ดูสมาชิกจากการสนทนาและพื้นที่ทำงานใน Chat เป็นแอปใน 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
https://www.googleapis.com/auth/chat.users.sections ดู สร้าง อัปเดต และลบส่วนต่างๆ ใน Chat รวมถึงย้ายและแสดงรายการต่างๆ ในส่วนใน Chat
https://www.googleapis.com/auth/chat.users.sections.readonly ดูส่วนต่างๆ และรายการในส่วนนั้นๆ ใน 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.app.messages.readonly

ดูข้อความและความรู้สึกใน Chat ในฐานะแอปใน Chat ต้องได้รับการอนุมัติจากผู้ดูแลระบบ

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

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

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

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

หากแอปของคุณต้องการสิทธิ์เข้าถึง Google API อื่นๆ คุณก็เพิ่มขอบเขตเหล่านั้นได้เช่นกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขตของ 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 ของคุณเข้าไป แอปใน 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 และขอบเขตการให้สิทธิ์ที่รองรับ

วิธีการ รองรับการตรวจสอบสิทธิ์ของผู้ใช้ รองรับการตรวจสอบสิทธิ์ของแอป ขอบเขตการให้สิทธิ์ที่รองรับ
Spaces  
สร้างพื้นที่ทำงาน เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • 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.app.messages.readonly
แสดงข้อความ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.messages.readonly
  • chat.messages
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์แอปและการอนุมัติจากผู้ดูแลระบบ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.app.messages.readonly
ค้นหาข้อความ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.messages.readonly
  • chat.messages
อัปเดตข้อความ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.messages
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์แอป คุณจะทำสิ่งต่อไปนี้ได้
  • chat.bot
ลบข้อความ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.messages
  • chat.import
เมื่อใช้การตรวจสอบสิทธิ์แอป คุณจะทำสิ่งต่อไปนี้ได้
  • chat.bot
ตรึงข้อความ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.spaces.pins
  • chat.spaces
เลิกปักหมุดข้อความ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.spaces.pins
  • chat.spaces
แสดงข้อความที่ปักหมุด — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.spaces.pins.readonly
  • chat.spaces.readonly
  • chat.spaces.pins
  • chat.spaces
อัปเดตการ์ดในข้อความ — เมื่อใช้การตรวจสอบสิทธิ์แอป คุณจะทำสิ่งต่อไปนี้ได้
  • 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
Sections  
สร้างส่วน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.users.sections
ลบส่วน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.users.sections
ส่วนของรายการ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.users.sections
  • chat.users.sections.readonly
อัปเดตส่วน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.users.sections
จัดตำแหน่งส่วน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.users.sections
รายการในส่วน  
ย้ายรายการในส่วน — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.users.sections
รายการในส่วนรายการ — เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณจะทำสิ่งต่อไปนี้ได้
  • chat.users.sections
  • chat.users.sections.readonly

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

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

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