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