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