คู่มือนี้จะอธิบายวิธีใช้เมธอด get()
ในทรัพยากร Message
ของ Google Chat API เพื่อแสดงรายละเอียดเกี่ยวกับข้อความแบบข้อความหรือการ์ด
ใน Chat API ข้อความใน Chat จะแสดงด้วยส่วนหัว
แหล่งข้อมูล Message
แม้ว่าผู้ใช้ Chat จะส่งได้เฉพาะข้อความที่มีข้อความ แต่แอป Chat สามารถใช้ฟีเจอร์การรับส่งข้อความอื่นๆ อีกมากมาย ซึ่งรวมถึงการแสดงอินเทอร์เฟซผู้ใช้แบบคงที่หรือแบบอินเทอร์แอกทีฟ การเก็บรวบรวมข้อมูลจากผู้ใช้ และการนำส่งข้อความแบบส่วนตัว หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการรับส่งข้อความ
ฟีเจอร์ที่ใช้ได้กับ Chat API โปรดดู
ภาพรวมข้อความ Google Chat
ข้อกำหนดเบื้องต้น
Node.js
- บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมของคุณ
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API โดยใช้ชื่อ ไอคอนและคำอธิบายสำหรับแอป Chat ของคุณ
- ติดตั้ง ไลบรารีของไคลเอ็นต์ Cloud สำหรับ Node.js
- สร้างข้อมูลเข้าสู่ระบบตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ในคำขอ Google Chat API ดังนี้
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ที่มีชื่อว่า
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์เป็นผู้ใช้หรือ แอป Chat
- พื้นที่ทำงาน Google Chat ที่ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์หรือแอป Google Chat ที่โทรเป็นสมาชิก วิธีตรวจสอบสิทธิ์เป็น แอปใน Chat ให้เพิ่มแอป ส่งแอป Chat ไปยังพื้นที่ทำงาน
Python
- บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมของคุณ
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมตั้งชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- ติดตั้ง งูหลาม ไลบรารีของไคลเอ็นต์ระบบคลาวด์
- สร้างข้อมูลเข้าสู่ระบบโดยอิงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ใน Google Chat API
คำขอ:
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ลงในไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ที่มีชื่อว่า
credentials.json
- หากต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat ให้สร้างข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์ OAuth และบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์เป็นผู้ใช้หรือ แอป Chat
- พื้นที่ใน Google Chat ที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์หรือ ที่โทรหาแอป Chat เป็นสมาชิก หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้เพิ่มแอป Chat ไปยังพื้นที่ทำงาน
Java
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมของคุณ
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมตั้งชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- ติดตั้ง ชวา ไลบรารีของไคลเอ็นต์ระบบคลาวด์
- สร้างข้อมูลเข้าสู่ระบบโดยอิงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ใน Google Chat API
คำขอ:
- วิธีตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
สร้างรหัสไคลเอ็นต์ OAuth
ข้อมูลเข้าสู่ระบบและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ไปยังไดเรกทอรีในเครื่อง - หากต้องการตรวจสอบสิทธิ์ในฐานะแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ แล้วบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ที่มีชื่อว่า
credentials.json
- วิธีตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
สร้างรหัสไคลเอ็นต์ OAuth
ข้อมูลเข้าสู่ระบบและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์เป็นผู้ใช้หรือ แอป Chat
- พื้นที่ใน Google Chat ที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์หรือ ที่โทรหาแอป Chat เป็นสมาชิก วิธีตรวจสอบสิทธิ์เป็น แอปใน Chat ให้เพิ่มแอป ส่งแอป Chat ไปยังพื้นที่ทำงาน
Apps Script
- บัญชี Google Workspace รุ่น Business หรือ Enterprise ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมของคุณ
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกําหนดค่า Google Chat API พร้อมตั้งชื่อ ไอคอน และคําอธิบายสําหรับแอป Chat
- สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน และเปิดบริการแชทขั้นสูง
- ในคู่มือนี้ คุณต้องใช้การตรวจสอบสิทธิ์ผู้ใช้หรือแอป หากต้องการตรวจสอบสิทธิ์เป็นแอป Chat ให้สร้างข้อมูลเข้าสู่ระบบของบัญชีบริการ ดูขั้นตอนได้ที่หัวข้อตรวจสอบสิทธิ์และให้สิทธิ์ในฐานะแอป Google Chat
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์ในฐานะผู้ใช้หรือแอปใน Chat
- พื้นที่ทำงาน Google Chat ที่ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์หรือแอป Google Chat ที่โทรเป็นสมาชิก วิธีตรวจสอบสิทธิ์เป็น แอปใน Chat ให้เพิ่มแอป ส่งแอป Chat ไปยังพื้นที่ทำงาน
รับข้อความที่มีการตรวจสอบสิทธิ์ผู้ใช้
หากต้องการดูรายละเอียดเกี่ยวกับข้อความที่มีการตรวจสอบสิทธิ์ผู้ใช้ ให้ส่งข้อมูลต่อไปนี้ในคำขอ
- ระบุขอบเขตการให้สิทธิ์
chat.messages.readonly
หรือchat.messages
- เรียกใช้เมธอด
GetMessage()
- ตั้งค่า
name
เป็นชื่อทรัพยากรของข้อความเพื่อรับ
ตัวอย่างต่อไปนี้ได้รับข้อความที่มี การตรวจสอบสิทธิ์ผู้ใช้:
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ข้อมูลต่อไปนี้
SPACE_NAME
: รหัสจากพื้นที่ทำงานname
คุณสามารถรับรหัสโดยโทรไปที่ListSpaces()
หรือจาก URL ของพื้นที่ทำงานMESSAGE_NAME
: รหัสจากname
ของข้อความ คุณดูรหัสได้จากเนื้อหาการตอบกลับที่แสดงผลหลังจากสร้างข้อความแบบไม่พร้อมกันด้วย Chat API หรือชื่อที่กำหนดเองที่กำหนดให้กับข้อความเมื่อสร้าง
Chat API จะแสดงผลอินสแตนซ์
Message
ซึ่งให้รายละเอียดข้อความที่ระบุ
รับข้อความที่มีการตรวจสอบสิทธิ์แอป
วิธีดูรายละเอียดเกี่ยวกับข้อความที่มี การตรวจสอบสิทธิ์แอป ส่งต่อสิ่งต่อไปนี้ในคำขอของคุณ
- ระบุ
chat.bot
ขอบเขตการให้สิทธิ์ - เรียกใช้เมธอด
GetMessage()
- ตั้งค่า
name
เป็นชื่อทรัพยากรของข้อความเพื่อรับ
ตัวอย่างต่อไปนี้ได้รับข้อความที่มีการตรวจสอบสิทธิ์แอป
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่รายการต่อไปนี้
SPACE_NAME
: รหัสจากพื้นที่ทำงานname
คุณสามารถรับรหัสโดยโทรไปที่ListSpaces()
หรือจาก URL ของพื้นที่ทำงานMESSAGE_NAME
: รหัสจากname
ของข้อความ คุณสามารถดูรหัสจากเนื้อหาการตอบกลับที่ส่งคืนหลังจากสร้าง ข้อความแบบไม่พร้อมกันด้วย Chat API หรือ ชื่อที่กำหนดเอง ที่กำหนดให้กับข้อความขณะสร้าง
Chat API จะแสดงผลอินสแตนซ์
Message
ซึ่งให้รายละเอียดข้อความที่ระบุ