คู่มือนี้จะอธิบายวิธีเรียก API ของ Google Chat
messages.create()
ในการดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- ส่งข้อความที่มีข้อความ การ์ด และวิดเจ็ตแบบอินเทอร์แอกทีฟ
- ส่งข้อความแบบส่วนตัวไปยังผู้ใช้ Chat ที่ระบุ
- เริ่มหรือตอบกลับชุดข้อความ
- ตั้งชื่อข้อความเพื่อให้คุณระบุใน Chat API อื่นๆ ได้ คำขอ
ขนาดสูงสุดของข้อความ (รวมถึงข้อความหรือการ์ดทั้งหมด) คือ 32,000 ไบต์ หากต้องการส่งข้อความที่มีขนาดใหญ่กว่านี้ แอป Chat ของคุณ ต้องส่งข้อความหลายรายการแทน
นอกจากการเรียกใช้เมธอด messages.create()
แล้ว แอป Chat
สามารถสร้างและส่งข้อความเพื่อตอบกลับการโต้ตอบของผู้ใช้ เช่น การโพสต์
ข้อความต้อนรับหลังจากที่ผู้ใช้เพิ่มแอป Chat ลงใน
พื้นที่ทำงาน เมื่อตอบกลับการโต้ตอบ แอป Chat จะใช้
ประเภทของฟีเจอร์การรับส่งข้อความ รวมถึงกล่องโต้ตอบแบบอินเทอร์แอกทีฟและการแสดงตัวอย่างลิงก์
อินเทอร์เฟซ หากต้องการตอบกลับผู้ใช้ แอป Chat จะกลับมา
ข้อความพร้อมกันโดยไม่ต้องเรียกใช้ Chat API เพื่อเรียนรู้
เกี่ยวกับการส่งข้อความเพื่อตอบกลับการโต้ตอบ โปรดดูที่
รับและตอบกลับการโต้ตอบกับแอป Google Chat
วิธีที่ Chat แสดงและระบุแหล่งที่มาของข้อความที่สร้างด้วย Chat API
คุณสามารถเรียกเมธอด messages.create()
โดยใช้
การตรวจสอบสิทธิ์แอป
และการตรวจสอบสิทธิ์ผู้ใช้
Chat ระบุแหล่งที่มาของผู้ส่งข้อความแตกต่างกัน
โดยขึ้นอยู่กับประเภทการตรวจสอบสิทธิ์ที่คุณใช้
เมื่อคุณตรวจสอบสิทธิ์ว่าเป็นแอป Chat แอป Chat จะส่งข้อความนั้น
เมื่อคุณตรวจสอบสิทธิ์ในฐานะผู้ใช้ แอป Chat จะส่ง ข้อความในนามของผู้ใช้ Chat ยังระบุแหล่งที่มา แชทกับแอปโดยการแสดงชื่อ
ประเภทการตรวจสอบสิทธิ์จะกำหนดฟีเจอร์และอินเทอร์เฟซการรับส่งข้อความด้วย ที่คุณสามารถใส่ไว้ในข้อความ การตรวจสอบสิทธิ์แอป แอปแชทสามารถส่งข้อความที่มี Rich Text ได้ อินเทอร์เฟซแบบการ์ด และวิดเจ็ตแบบอินเทอร์แอกทีฟ เนื่องจากผู้ใช้ Chat จะส่งได้เฉพาะข้อความตัวอักษรเท่านั้น คุณจึงดำเนินการต่อไปนี้ได้ รวมเฉพาะข้อความเมื่อสร้างข้อความโดยใช้การตรวจสอบสิทธิ์ผู้ใช้ หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการรับส่งข้อความ ฟีเจอร์ที่ใช้ได้กับ Chat API โปรดดู ภาพรวมข้อความ Google Chat
คำแนะนำนี้จะอธิบายวิธีใช้การตรวจสอบสิทธิ์ประเภทใดประเภทหนึ่งในการส่งข้อความ ด้วย Chat API
ข้อกำหนดเบื้องต้น
Node.js
- ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API โดยใช้ชื่อ ไอคอนและคำอธิบายสำหรับแอป Chat
- ติดตั้ง Node.js ไลบรารีของไคลเอ็นต์ระบบคลาวด์
- สร้างข้อมูลเข้าสู่ระบบโดยอิงตามวิธีที่คุณต้องการตรวจสอบสิทธิ์ใน Google Chat API
คำขอ:
- วิธีตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
สร้างรหัสไคลเอ็นต์ OAuth
ข้อมูลเข้าสู่ระบบและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
client_secrets.json
ไปยังไดเรกทอรีในเครื่อง - วิธีตรวจสอบสิทธิ์ว่าเป็นแอป Chat
สร้างบัญชีบริการ
ข้อมูลเข้าสู่ระบบและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
credentials.json
- วิธีตรวจสอบสิทธิ์ในฐานะผู้ใช้ Chat
สร้างรหัสไคลเอ็นต์ OAuth
ข้อมูลเข้าสู่ระบบและบันทึกข้อมูลเข้าสู่ระบบเป็นไฟล์ JSON ชื่อ
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์เป็นผู้ใช้หรือ แอป Chat
- พื้นที่ใน Google Chat ที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์หรือ ที่โทรหาแอป Chat เป็นสมาชิก วิธีตรวจสอบสิทธิ์เป็น แอปใน Chat ให้เพิ่มแอป ส่งแอป Chat ไปยังพื้นที่ทำงาน
Python
- ธุรกิจหรือองค์กร บัญชี 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 ไปยังพื้นที่ทำงาน
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 ที่มีสิทธิ์เข้าถึง Google Chat
- ตั้งค่าสภาพแวดล้อมโดยทำดังนี้
- สร้างโปรเจ็กต์ Google Cloud
- กำหนดค่าหน้าจอขอความยินยอม OAuth
- เปิดใช้และกำหนดค่า Google Chat API โดยใช้ชื่อ ไอคอนและคำอธิบายสำหรับแอป Chat
- สร้างโปรเจ็กต์ Apps Script แบบสแตนด์อโลน แล้วเปิดบริการ Chat ขั้นสูง
- ในคู่มือนี้คุณต้องใช้ผู้ใช้ หรือแอป หากต้องการตรวจสอบสิทธิ์ว่าเป็นแอป Chat ให้สร้าง ข้อมูลเข้าสู่ระบบของบัญชีบริการ โปรดดูขั้นตอนในหัวข้อ ตรวจสอบสิทธิ์และให้สิทธิ์ แอป Google Chat
- เลือกขอบเขตการให้สิทธิ์โดยพิจารณาว่าคุณต้องการตรวจสอบสิทธิ์เป็นผู้ใช้หรือ แอป Chat
- พื้นที่ใน Google Chat ที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์หรือ ที่โทรหาแอป Chat เป็นสมาชิก วิธีตรวจสอบสิทธิ์เป็น แอปใน Chat ให้เพิ่มแอป ส่งแอป Chat ไปยังพื้นที่ทำงาน
ส่งข้อความเป็นแอป Chat
ส่วนนี้อธิบายวิธีส่งข้อความที่มีข้อความ การ์ด และ วิดเจ็ตอุปกรณ์เสริมแบบอินเทอร์แอกทีฟโดยใช้ การตรวจสอบสิทธิ์แอป
หากต้องการเรียก messages.create()
โดยใช้การตรวจสอบสิทธิ์แอป คุณต้องระบุ
ฟิลด์ต่อไปนี้ในคำขอ
- ขอบเขตการให้สิทธิ์
chat.bot
- ทรัพยากร
Space
ที่ ที่คุณต้องการโพสต์ข้อความ แอป Chat ต้องมีคุณสมบัติต่อไปนี้ สมาชิกของพื้นที่ทำงาน Message
ทรัพยากรในการสร้าง หากต้องการกำหนดเนื้อหาของข้อความ คุณสามารถใส่ Rich Text (text
) อินเทอร์เฟซของการ์ดอย่างน้อย 1 รายการ (cardsV2
), หรือทั้งสองอย่าง
คุณสามารถรวมสิ่งต่อไปนี้ได้ (ไม่บังคับ)
- ช่อง
accessoryWidgets
ที่จะรวม ปุ่มโต้ตอบที่ด้านล่างของข้อความ - ช่อง
privateMessageViewer
เพื่อ ส่งข้อความแบบส่วนตัวถึงผู้ใช้ที่ระบุ - ฟิลด์
messageId
ซึ่งช่วยให้คุณ ตั้งชื่อข้อความเพื่อใช้ในคำขอ API อื่นๆ - ฟิลด์
thread.threadKey
และmessageReplyOption
เพื่อ เริ่มต้นหรือตอบกลับชุดข้อความ หากพื้นที่ทำงานไม่มี ใช้ Threading ระบบจะไม่สนใจช่องนี้
โค้ดต่อไปนี้แสดงตัวอย่างวิธีที่แอป Chat สามารถส่งข้อความที่โพสต์เป็นแอป Chat ที่มี ข้อความ การ์ด และปุ่มที่คลิกได้ที่ด้านล่างของข้อความ
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ SPACE_NAME
ด้วยรหัสจาก
ของ Space
name
คุณสามารถรับรหัสโดยโทรไปที่
spaces.list()
วิธี
หรือจาก URL ของพื้นที่ทำงาน
เพิ่มวิดเจ็ตแบบอินเทอร์แอกทีฟที่ด้านล่างของข้อความ
ในตัวอย่างโค้ดแรกของคู่มือนี้ ข้อความแอปใน Chat จะแสดงปุ่มที่คลิกได้ที่ ที่ด้านล่างของข้อความ ซึ่งเรียกว่าวิดเจ็ตอุปกรณ์เสริม วิดเจ็ตอุปกรณ์เสริม ปรากฏหลังข้อความหรือการ์ดในข้อความ คุณสามารถใช้วิดเจ็ตเหล่านี้เพื่อเรียกข้อความแจ้ง โต้ตอบกับข้อความของคุณได้หลายวิธี เช่น
- ให้คะแนนความถูกต้องหรือความพึงพอใจของข้อความ
- รายงานปัญหาเกี่ยวกับข้อความหรือแอป Chat
- เปิดลิงก์ไปยังเนื้อหาที่เกี่ยวข้อง เช่น เอกสารประกอบ
- ปิดหรือเลื่อนการแจ้งเตือนข้อความที่คล้ายกันจากแอป Chat สำหรับระยะเวลาที่กำหนด
หากต้องการเพิ่มวิดเจ็ตอุปกรณ์เสริม ให้ใส่
accessoryWidgets[]
ในส่วนเนื้อหาของคำขอ และระบุวิดเจ็ตที่คุณต้องการ
ที่จะรวม
รูปภาพต่อไปนี้แสดงแอปใน Chat ที่ต่อท้าย ข้อความที่มีวิดเจ็ตอุปกรณ์เสริมเพื่อให้ผู้ใช้ให้คะแนนประสบการณ์การใช้งาน ด้วยแอป Chat
รายการต่อไปนี้จะแสดงเนื้อหาของคำขอที่สร้างข้อความตัวอักษรด้วย
ปุ่มเสริม 2 ปุ่ม เมื่อผู้ใช้คลิกปุ่ม โฆษณาที่สอดคล้องกัน
(เช่น doUpvote
) ประมวลผลการโต้ตอบ:
{
text: "Rate your experience with this Chat app.",
accessoryWidgets: [{ buttonList: { buttons: [{
icon: { material_icon: {
name: "thumb_up"
}},
color: { red: 0, blue: 255, green: 0 },
onClick: { action: {
function: "doUpvote"
}}
}, {
icon: { material_icon: {
name: "thumb_down"
}},
color: { red: 0, blue: 255, green: 0 },
onClick: { action: {
function: "doDownvote"
}}
}]}}]
}
ส่งข้อความแบบส่วนตัว
แอปแชทสามารถส่งข้อความแบบส่วนตัวได้เพื่อให้ ข้อความจะปรากฏแก่ผู้ใช้บางรายในพื้นที่ทำงานเท่านั้น เมื่อ แอปแชทจะส่งข้อความส่วนตัว ข้อความ แสดงป้ายกำกับที่แจ้งให้ผู้ใช้ทราบว่ามีเพียงผู้ใช้เท่านั้นที่จะเห็นข้อความ
หากต้องการส่งข้อความแบบส่วนตัวโดยใช้ Chat API ให้ระบุ
privateMessageViewer
ในส่วนเนื้อหาของคำขอ หากต้องการระบุผู้ใช้ ให้คุณกำหนดค่าเป็น
ทรัพยากร User
ที่
แสดงถึงผู้ใช้ Chat คุณยังสามารถใช้
ฟิลด์ name
ของฟิลด์
ทรัพยากร User
ดังที่แสดงในตัวอย่างต่อไปนี้
{
text: "Hello private world!",
privateMessageViewer: {
name: "users/USER_ID"
}
}
หากต้องการใช้ตัวอย่างนี้ ให้แทนที่ USER_ID
ที่มีรหัสที่ไม่ซ้ำกันสำหรับผู้ใช้ เช่น 12345678987654321
หรือ
hao@cymbalgroup.com
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการระบุผู้ใช้ โปรดดู
ระบุและระบุผู้ใช้ Google Chat
หากต้องการส่งข้อความแบบส่วนตัว คุณต้องละเว้นข้อมูลต่อไปนี้ในคำขอ
ส่งข้อความในนามของผู้ใช้
ส่วนนี้จะอธิบายวิธีส่งข้อความในนามของผู้ใช้โดยใช้ การตรวจสอบสิทธิ์ผู้ใช้ เมื่อใช้การตรวจสอบสิทธิ์ผู้ใช้ เนื้อหาของข้อความจะมีได้เฉพาะข้อความเท่านั้น และต้องละเว้นฟีเจอร์การรับส่งข้อความที่ใช้ได้เฉพาะ แอปแชท รวมถึงอินเทอร์เฟซการ์ดและวิดเจ็ตแบบอินเทอร์แอกทีฟ
หากต้องการเรียก messages.create()
โดยใช้การตรวจสอบสิทธิ์ผู้ใช้ คุณต้องระบุ
ฟิลด์ต่อไปนี้ในคำขอ
- ขอบเขตการให้สิทธิ์
ที่สนับสนุนการตรวจสอบสิทธิ์ผู้ใช้สำหรับวิธีนี้ ตัวอย่างต่อไปนี้ใช้
ขอบเขต
chat.messages.create
- ทรัพยากร
Space
ที่ ที่คุณต้องการโพสต์ข้อความ ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วต้องเป็นสมาชิกของ พื้นที่ทำงาน Message
ทรัพยากรในการสร้าง หากต้องการกำหนดเนื้อหาของข้อความ คุณต้องใส่text
ด้วย
คุณสามารถรวมสิ่งต่อไปนี้ได้ (ไม่บังคับ)
- ฟิลด์
messageId
ซึ่งช่วยให้คุณ ตั้งชื่อข้อความเพื่อใช้ในคำขอ API อื่นๆ - ฟิลด์
thread.threadKey
และmessageReplyOption
เพื่อ เริ่มต้นหรือตอบกลับชุดข้อความ หากพื้นที่ทำงานไม่มี ใช้ Threading ระบบจะไม่สนใจช่องนี้
โค้ดต่อไปนี้แสดงตัวอย่างวิธีที่แอป Chat สามารถส่ง SMS ในพื้นที่ทำงานที่ระบุในนามของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว ดังนี้
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่ SPACE_NAME
ด้วยรหัสจาก
ของ Space
name
ด้วย คุณสามารถรับรหัสโดยโทรไปที่
spaces.list()
วิธี
หรือจาก URL ของพื้นที่ทำงาน
เริ่มหรือตอบกลับในชุดข้อความ
สำหรับพื้นที่ทำงานที่ใช้ชุดข้อความ คุณจะระบุได้ว่าข้อความใหม่จะเริ่มชุดข้อความหรือตอบกลับ ชุดข้อความที่มีอยู่
โดยค่าเริ่มต้น ข้อความที่คุณสร้างโดยใช้ Chat API จะเริ่มต้นใหม่ ชุดข้อความ เพื่อช่วยให้คุณระบุชุดข้อความและตอบกลับชุดข้อความนั้นในภายหลังได้ คุณสามารถระบุ คีย์เทรดในคําขอของคุณ:
- ในส่วนเนื้อหาของคําขอ ให้ระบุ
thread.threadKey
ด้วย - ระบุพารามิเตอร์การค้นหา
messageReplyOption
เพื่อดูว่าจะเกิดอะไรขึ้นหากมีคีย์อยู่แล้ว
วิธีสร้างข้อความที่ตอบกลับชุดข้อความที่มีอยู่
- ในส่วนเนื้อหาของคำขอ ให้ใส่ช่อง
thread
หากตั้งค่าไว้ คุณจะทำสิ่งต่อไปนี้ได้ ระบุthreadKey
ที่คุณสร้างขึ้น มิฉะนั้น คุณต้องใช้name
ของชุดข้อความ - ระบุพารามิเตอร์การค้นหา
messageReplyOption
โค้ดต่อไปนี้แสดงตัวอย่างวิธีที่แอป Chat สามารถส่งข้อความที่ขึ้นต้นหรือตอบกลับชุดข้อความที่ระบุโดย คีย์ของพื้นที่หนึ่งๆ ในนามของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่รายการต่อไปนี้
THREAD_KEY
: คีย์ Thread ที่มีอยู่ในพื้นที่ทำงาน หรือ เพื่อสร้างชุดข้อความใหม่ ซึ่งจะมีชื่อที่ไม่ซ้ำกันสำหรับชุดข้อความนั้นSPACE_NAME
: รหัสจากพื้นที่ทำงานname
ด้วย คุณสามารถรับรหัสโดยโทรไปที่spaces.list()
วิธี หรือจาก URL ของพื้นที่ทำงาน
ตั้งชื่อข้อความ
หากต้องการเรียกหรือระบุข้อความสำหรับการเรียก API ในอนาคต คุณสามารถตั้งชื่อข้อความได้
โดยการตั้งค่าฟิลด์ messageId
ในคำขอ messages.create()
การตั้งชื่อข้อความช่วยให้คุณสามารถระบุข้อความได้โดยไม่ต้องจัดเก็บ
รหัสที่ระบบกำหนดจากชื่อทรัพยากรของข้อความ (แสดงใน
name
)
ตัวอย่างเช่น ในการเรียกข้อความโดยใช้เมธอด get()
ให้ใช้เมธอด
ชื่อทรัพยากรเพื่อระบุข้อความที่จะเรียก ชื่อทรัพยากรคือ
มีรูปแบบเป็น spaces/{space}/messages/{message}
โดยที่ {message}
แสดงถึง
รหัสที่ระบบกําหนด หรือชื่อที่กําหนดเองซึ่งคุณตั้งค่าไว้เมื่อคุณสร้าง
หากต้องการตั้งชื่อข้อความ ให้ระบุรหัสที่กำหนดเองใน
messageId
เมื่อคุณสร้างข้อความ ฟิลด์ messageId
จะตั้งค่าค่าของฟิลด์
clientAssignedMessageId
ของทรัพยากร Message
คุณสามารถตั้งชื่อข้อความได้เฉพาะเมื่อสร้างข้อความเท่านั้น คุณไม่สามารถตั้งชื่อหรือ แก้ไขรหัสที่กำหนดเองสำหรับข้อความที่มีอยู่ รหัสที่กำหนดเองต้องเป็นไปตามข้อกำหนดต่อไปนี้ ข้อกำหนด
- ขึ้นต้นด้วย
client-
เช่นclient-custom-name
เป็นที่กําหนดเองที่ถูกต้อง รหัส แต่custom-name
ไม่ใช่รหัส - มีอักขระได้สูงสุด 63 ตัว และมีเฉพาะตัวพิมพ์เล็ก ตัวเลข และ ขีดกลาง
- ไม่ซ้ำกันภายในพื้นที่ทำงาน แอป Chat ไม่สามารถใช้ รหัสที่กำหนดเองเดียวกันสำหรับข้อความที่แตกต่างกัน
โค้ดต่อไปนี้แสดงตัวอย่างวิธีที่แอป Chat สามารถส่ง SMS ที่มีบัตรประจำตัวไปยังพื้นที่ทำงานที่ระบุในนามของ ผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว:
Node.js
Python
Java
Apps Script
หากต้องการเรียกใช้ตัวอย่างนี้ ให้แทนที่รายการต่อไปนี้
SPACE_NAME
: รหัสจากพื้นที่ทำงานname
ด้วย คุณสามารถรับรหัสโดยโทรไปที่spaces.list()
วิธี หรือจาก URL ของพื้นที่ทำงานMESSAGE-ID
: ชื่อสำหรับข้อความขึ้นต้น ด้วยcustom-
ต้องไม่ซ้ำกันจากชื่อข้อความอื่นๆ ที่สร้างโดย แอป Chat ในพื้นที่ทำงานที่ระบุ
แก้ปัญหา
เมื่อแอป Google Chat หรือ card จะแสดงผลข้อผิดพลาด อินเทอร์เฟซ Chat แสดงข้อความว่า "เกิดข้อผิดพลาด" หรือ "ไม่สามารถดำเนินการตามคำขอของคุณ" บางครั้ง UI ของ Chat ไม่แสดงข้อความแสดงข้อผิดพลาดใดๆ แต่แอป Chat หรือ ทำให้เกิดผลลัพธ์ที่ไม่คาดคิด เช่น ข้อความในการ์ดอาจ ปรากฏขึ้น
แม้ว่าข้อความแสดงข้อผิดพลาดอาจไม่แสดงใน UI ของแชท มีข้อความแสดงข้อผิดพลาดและข้อมูลบันทึกที่สื่อความหมายเพื่อช่วยคุณแก้ไขข้อผิดพลาด เมื่อมีการเปิดข้อผิดพลาดในการบันทึกสำหรับแอป Chat หากต้องการความช่วยเหลือในการดู การแก้ไขข้อบกพร่องและการแก้ไขข้อผิดพลาด โปรดดู แก้ปัญหาข้อผิดพลาดของ Google Chat
หัวข้อที่เกี่ยวข้อง
- ใช้เครื่องมือสร้างการ์ดเพื่อ ออกแบบและแสดงตัวอย่างข้อความการ์ด JSON สำหรับแอป Chat
- จัดรูปแบบข้อความ
- ดูรายละเอียดเกี่ยวกับข้อความ
- แสดงข้อความในพื้นที่ทำงาน
- อัปเดตข้อความ
- ลบข้อความ
- ระบุผู้ใช้ในข้อความใน Google Chat
- ส่งข้อความไปยัง Google Chat ด้วยเว็บฮุคขาเข้า