Method: spaces.messages.create

สร้างข้อความ ดูตัวอย่างได้ที่สร้างข้อความ

ต้องตรวจสอบสิทธิ์

การสร้าง SMS จะรองรับทั้งการตรวจสอบสิทธิ์ผู้ใช้และการตรวจสอบสิทธิ์แอป การตรวจสอบสิทธิ์ผู้ใช้ต้องใช้ขอบเขตการให้สิทธิ์ chat.messages หรือ chat.messages.create

การสร้างข้อความการ์ดต้องมีการตรวจสอบสิทธิ์แอป

เนื่องจาก Chat มีการตรวจสอบสิทธิ์สําหรับ เว็บฮุค ซึ่งเป็นส่วนหนึ่งของ URL ที่สร้างขึ้นเมื่อมีการลงทะเบียนเว็บฮุค เว็บฮุคจะสร้างข้อความได้โดยไม่ต้องมีบัญชีบริการหรือการตรวจสอบสิทธิ์ผู้ใช้

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

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

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

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

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

string

ไม่บังคับ เลิกใช้งานแล้ว: ใช้ thread.thread_key แทน ตัวระบุชุดทึบ หากต้องการเริ่มหรือเพิ่มลงในชุดข้อความ ให้สร้างข้อความและระบุ 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

สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์

ตัวเลือกข้อความตอบกลับ

ระบุวิธีตอบกลับข้อความ เราจะเพิ่มรัฐอื่นๆ ในอนาคต

Enum
MESSAGE_REPLY_OPTION_UNSPECIFIED ค่าเริ่มต้น เริ่มชุดข้อความ
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD สร้างข้อความเป็นการตอบกลับชุดข้อความที่ระบุโดย thread ID หรือ threadKey หากล้มเหลว ข้อความจะเริ่มชุดข้อความใหม่แทน
REPLY_MESSAGE_OR_FAIL สร้างข้อความเป็นการตอบกลับชุดข้อความที่ระบุโดย thread ID หรือ threadKey หากไม่สําเร็จ ระบบจะแสดงข้อผิดพลาด NOT_FOUND แทน