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

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

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

รหัสขอบเขต คำอธิบาย
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 ออก ต้องได้รับการอนุมัติจากผู้ดูแลระบบ

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

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

หากแอปของคุณต้องเข้าถึง Google API อื่นๆ คุณก็เพิ่มขอบเขตเหล่านั้นได้เช่นกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต 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 และ กำหนดค่าแอปใน 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.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 — —
การเรียกกลับของ Apps Script — —
Google Cloud Pub/Sub — —
วิธีตอบกลับข้อความ
แบบซิงโครนัสโดยใช้เหตุการณ์การโต้ตอบของแอป Chat — —
แบบพร้อมกันโดยใช้ค่าที่แสดงผลจากโค้ดเรียกกลับของ Apps Script — —
ส่งข้อความใหม่
ด้วยเว็บฮุคขาเข้า — —