Method: spaces.messages.create

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

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

รูปภาพต่อไปนี้แสดงวิธีที่ Chat ระบุแหล่งที่มาของข้อความเมื่อคุณใช้การตรวจสอบสิทธิ์ของแอป Chat จะแสดงแอป Chat เป็นผู้ส่งข้อความ เนื้อหาของข้อความอาจมีข้อความ (text) การ์ด (cardsV2) และวิดเจ็ตอุปกรณ์เสริม (accessoryWidgets)

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

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

ข้อความที่ส่งด้วยการตรวจสอบสิทธิ์ผู้ใช้

ขนาดข้อความสูงสุดซึ่งรวมถึงเนื้อหาข้อความคือ 32,000 ไบต์

สําหรับคําขอ webhook การตอบกลับจะไม่มีข้อความทั้งหมด การตอบกลับจะป้อนข้อมูลในช่อง name และ thread.name เท่านั้น นอกเหนือจากข้อมูลที่อยู่ในคำขอ

คำขอ 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 แทน