Method: spaces.messages.create

สร้างข้อความในพื้นที่ใน Google Chat ตัวอย่าง โปรดดูที่สร้างข้อความ

การเรียกใช้วิธีการนี้ต้องมีการตรวจสอบสิทธิ์และรองรับการตรวจสอบสิทธิ์ประเภทต่อไปนี้

  • ในกรณีที่ใช้ SMS ระบบจะรองรับการตรวจสอบสิทธิ์ผู้ใช้หรือการตรวจสอบสิทธิ์แอป
  • สำหรับข้อความบัตร จะรองรับเฉพาะการตรวจสอบสิทธิ์แอปเท่านั้น (เฉพาะแอปใน Chat เท่านั้นที่สามารถสร้างข้อความการ์ดได้)

คำขอ HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ ชื่อทรัพยากรของพื้นที่ทำงานที่จะสร้างข้อความ

รูปแบบ: spaces/{space}

พารามิเตอร์การค้นหา

พารามิเตอร์
threadKey
(deprecated)

string

ไม่บังคับ เลิกใช้งานแล้ว: ใช้ thread.thread_key แทน รหัสของชุดข้อความ รองรับอักขระสูงสุด 4,000 ตัว หากต้องการเริ่มหรือเพิ่มไปยังชุดข้อความ ให้สร้างข้อความและระบุ threadKey หรือ thread.name ตัวอย่างการใช้งาน โปรดดูหัวข้อเริ่มต้นหรือตอบกลับชุดข้อความ

requestId

string

ไม่บังคับ รหัสคำขอที่ไม่ซ้ำกันสำหรับข้อความนี้ การระบุรหัสคำขอที่มีอยู่จะแสดงผลข้อความที่สร้างขึ้นด้วยรหัสนั้นแทนการสร้างข้อความใหม่

messageReplyOption

enum (MessageReplyOption)

ไม่บังคับ ระบุว่าข้อความจะเริ่มชุดข้อความหรือตอบกลับ รองรับเฉพาะในพื้นที่ทำงานที่มีชื่อเท่านั้น

messageId

string

ไม่บังคับ ชื่อที่กำหนดเองของข้อความใน Chat ที่กำหนดขณะสร้าง ต้องขึ้นต้นด้วย client- และประกอบด้วยตัวอักษรพิมพ์เล็ก ตัวเลข และขีดกลางโดยมีความยาวไม่เกิน 63 อักขระ ระบุช่องนี้เพื่อรับ อัปเดต หรือลบข้อความที่มีค่าที่ระบุ การกำหนดชื่อที่กำหนดเองจะช่วยให้แอป Chat เรียกคืนข้อความได้โดยไม่ต้องบันทึกข้อความ name จากเนื้อหาการตอบกลับที่แสดงผลเมื่อสร้างข้อความ การกําหนดชื่อที่กําหนดเองจะไม่แทนที่ช่อง name ที่สร้างขึ้น ซึ่งเป็นชื่อทรัพยากรของข้อความ แต่จะตั้งชื่อที่กําหนดเองเป็นช่อง clientAssignedMessageId แทน ซึ่งคุณสามารถใช้อ้างอิงขณะประมวลผลในภายหลัง เช่น การอัปเดตหรือการลบข้อความ ดูตัวอย่างการใช้งานได้ที่หัวข้อตั้งชื่อข้อความที่สร้างขึ้น

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ 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 หรือ threadKey ที่มีอยู่
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD สร้างข้อความเป็นการตอบกลับชุดข้อความที่ระบุโดย thread ID หรือ threadKey หากไม่สำเร็จ ข้อความจะเริ่มชุดข้อความใหม่แทน
REPLY_MESSAGE_OR_FAIL สร้างข้อความเป็นการตอบกลับชุดข้อความที่ระบุโดย thread ID หรือ threadKey หากใช้ threadKey ใหม่ ระบบจะสร้างชุดข้อความใหม่ หากสร้างข้อความไม่สำเร็จ ระบบจะแสดงข้อผิดพลาด NOT_FOUND แทน