Method: spaces.messages.create

สร้างข้อความในพื้นที่ใน Google Chat ขนาดสูงสุดของข้อความรวมถึงข้อความและการ์ดคือ 32,000 ไบต์ ดูตัวอย่างได้ที่ส่งข้อความ

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

  • ในกรณีที่ใช้ 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 ดาวน์โหลด อัปเดต หรือลบข้อความโดยไม่ต้องจัดเก็บรหัสที่ระบบกำหนดไว้ในชื่อทรัพยากรของข้อความ (แสดงในช่อง name ของข้อความ)

ค่าสำหรับฟิลด์นี้ต้องเป็นไปตามข้อกำหนดต่อไปนี้

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