- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- MessageReplyOption
- ลองใช้งาน
สร้างข้อความในพื้นที่ใน Google Chat ขนาดสูงสุดของข้อความรวมถึงข้อความและการ์ดคือ 32,000 ไบต์ ดูตัวอย่างได้ที่ส่งข้อความ
การเรียกใช้วิธีการนี้ต้องใช้การตรวจสอบสิทธิ์และรองรับการตรวจสอบสิทธิ์ประเภทต่อไปนี้
- ในกรณีที่ใช้ SMS ระบบจะรองรับการตรวจสอบสิทธิ์ผู้ใช้หรือการตรวจสอบสิทธิ์แอป
- ส่วนข้อความบัตรจะรองรับเฉพาะการตรวจสอบสิทธิ์แอปเท่านั้น (เฉพาะแอปใน Chat เท่านั้นที่สามารถสร้างข้อความการ์ดได้)
คำขอ HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
parent |
ต้องระบุ ชื่อทรัพยากรของพื้นที่ทำงานที่จะสร้างข้อความ รูปแบบ: |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
threadKey |
ไม่บังคับ เลิกใช้งานแล้ว: ใช้ |
requestId |
ไม่บังคับ รหัสคำขอที่ไม่ซ้ำกันสำหรับข้อความนี้ การระบุรหัสคำขอที่มีอยู่จะแสดงผลข้อความที่สร้างขึ้นด้วยรหัสนั้นแทนการสร้างข้อความใหม่ |
messageReplyOption |
ไม่บังคับ ระบุว่าข้อความจะเริ่มชุดข้อความหรือตอบกลับไปที่ชุดข้อความ ใช้ได้เฉพาะในพื้นที่ทำงานที่มีชื่อ |
messageId |
ไม่บังคับ รหัสที่กำหนดเองสำหรับข้อความ อนุญาตให้แอป Chat ดาวน์โหลด อัปเดต หรือลบข้อความโดยไม่ต้องจัดเก็บรหัสที่ระบบกำหนดไว้ในชื่อทรัพยากรของข้อความ (แสดงในช่อง ค่าสำหรับฟิลด์นี้ต้องเป็นไปตามข้อกำหนดต่อไปนี้
โปรดดูรายละเอียดที่หัวข้อตั้งชื่อข้อความ |
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ Message
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Message
ที่สร้างขึ้นใหม่
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.create
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์
MessageReplyOption
ระบุวิธีตอบกลับข้อความ อาจมีการเพิ่มรัฐอื่นๆ อีกในอนาคต
Enum | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
ค่าเริ่มต้น เริ่มชุดข้อความใหม่ การใช้ตัวเลือกนี้จะไม่สนใจ thread ID หรือ ที่มีอยู่ |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
สร้างข้อความเป็นการตอบกลับชุดข้อความที่ระบุโดย thread ID หรือ หากไม่สำเร็จ ระบบจะแสดงข้อความดังกล่าวแทนชุดข้อความใหม่ |
REPLY_MESSAGE_OR_FAIL |
สร้างข้อความเป็นการตอบกลับชุดข้อความที่ระบุโดย thread ID หรือ หากใช้ threadKey ใหม่ ระบบจะสร้างชุดข้อความใหม่ หากสร้างข้อความไม่สำเร็จ ระบบจะแสดงข้อผิดพลาด NOT_FOUND แทน |