REST Resource: spaces.messages

{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ]
}

string

ชื่อทรัพยากรในรูปแบบ spaces/*/messages/*

เช่น spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

object (User)

เอาต์พุตเท่านั้น ผู้ใช้ที่สร้างข้อความ หากแอป Chat ตรวจสอบสิทธิ์เป็นผู้ใช้ เอาต์พุตจะแสดงข้อมูลผู้ใช้ name และ type

string (Timestamp format)

สําหรับพื้นที่ทำงานที่สร้างใน Chat เวลาสร้างข้อความ ช่องนี้เป็นเอาต์พุตเท่านั้น ยกเว้นเมื่อใช้ในพื้นที่ทำงานที่นําเข้า

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่ผู้ใช้แก้ไขข้อความครั้งล่าสุด หากไม่เคยแก้ไขข้อความ ช่องนี้จะว่างเปล่า

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่ข้อความถูกลบใน Google Chat หากไม่ได้ลบข้อความเลย ช่องนี้จะว่างเปล่า

string

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

หากต้องการเรียนรู้เกี่ยวกับการสร้าง SMS โปรดดูที่ส่งข้อความ

string

เอาต์พุตเท่านั้น มีข้อความ text พร้อมมาร์กอัปที่เพิ่มเพื่อสื่อสารการจัดรูปแบบ ช่องนี้อาจไม่ได้บันทึกการจัดรูปแบบทั้งหมดที่มองเห็นได้ใน UI แต่จะรวมรูปแบบต่อไปนี้

• ไวยากรณ์มาร์กอัปสำหรับบล็อกตัวหนา ตัวเอียง ขีดทับ ความกว้างอักษรขนาดเดียว และบล็อกที่มีความกว้างอักษรขนาดเดียว

• ผู้ใช้พูดถึงโดยใช้รูปแบบ <users/{user}>

• ไฮเปอร์ลิงก์ที่กำหนดเองโดยใช้รูปแบบ <{url}|{rendered_text}> โดยที่สตริงแรกเป็น URL และไฮเปอร์ลิงก์ที่ 2 คือข้อความที่แสดงผล เช่น <http://example.com|custom text>

• อีโมจิที่กำหนดเองโดยใช้รูปแบบ :{emoji_name}: เช่น :smile: แต่ใช้ไม่ได้กับอีโมจิแบบ Unicode เช่น U+1F600 สำหรับอีโมจิหน้ายิ้ม

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อดูการจัดรูปแบบข้อความที่ส่งในข้อความ

object (Card)

เลิกใช้งานแล้ว: ใช้ cardsV2 แทน

การ์ดแบบอินเทอร์แอกทีฟที่มีการจัดรูปแบบและแบบอินเทอร์แอกทีฟที่คุณสามารถใช้เพื่อแสดงองค์ประกอบ UI เช่น ข้อความที่จัดรูปแบบ ปุ่ม และรูปภาพที่คลิกได้ โดยทั่วไปการ์ดจะแสดงใต้เนื้อหาข้อความธรรมดาของข้อความ cards และ cardsV2 มีขนาดได้สูงสุด 32 KB

object (CardWithId)

อาร์เรย์ของการ์ด

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

ดูข้อมูลเกี่ยวกับการ์ดและวิธีสร้างได้ที่หัวข้อออกแบบ UI แบบไดนามิก อินเทอร์แอกทีฟ และมีความสอดคล้องด้วยการ์ด

object (Annotation)

เอาต์พุตเท่านั้น คำอธิบายประกอบที่เกี่ยวข้องกับ text ในข้อความนี้

object (Thread)

ชุดข้อความที่มีข้อความอยู่ ตัวอย่างการใช้งาน โปรดดูหัวข้อเริ่มหรือตอบชุดข้อความ

object (Space)

หากแอป Chat ตรวจสอบสิทธิ์ในฐานะผู้ใช้ เอาต์พุตจะแสดงพื้นที่ทำงาน name

string

คำอธิบายแบบข้อความธรรมดาของการ์ดข้อความ ซึ่งจะใช้เมื่อแสดงการ์ดจริงไม่ได้ เช่น การแจ้งเตือนในอุปกรณ์เคลื่อนที่

object (ActionResponse)

อินพุตเท่านั้น พารามิเตอร์ที่แอป Chat ใช้กำหนดค่าวิธีโพสต์คำตอบได้

string

เอาต์พุตเท่านั้น เนื้อหาข้อความธรรมดาที่มีการพูดถึงแอป Chat ทั้งหมดซึ่งถูกตัดออก

object (SlashCommand)

เอาต์พุตเท่านั้น ข้อมูลคำสั่งเครื่องหมายทับ (หากมี)

object (Attachment)

ไฟล์แนบที่อัปโหลดโดยผู้ใช้

object (MatchedUrl)

เอาต์พุตเท่านั้น URL ใน spaces.messages.text ที่ตรงกับรูปแบบตัวอย่างลิงก์ ดูข้อมูลเพิ่มเติมได้ที่แสดงตัวอย่างลิงก์

boolean

เอาต์พุตเท่านั้น เมื่อ true ข้อความจะเป็นการตอบกลับในชุดข้อความตอบกลับ เมื่อ false ข้อความจะปรากฏในการสนทนาระดับบนสุดของพื้นที่ทำงานว่าเป็นข้อความแรกของชุดข้อความหรือข้อความที่ไม่มีการตอบกลับแบบแยกชุดข้อความ

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

string

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

object (EmojiReactionSummary)

เอาต์พุตเท่านั้น รายการสรุปรีแอ็กชันด้วยอีโมจิในข้อความ

object (DeletionMetadata)

เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับข้อความที่ถูกลบ ระบบจะลบข้อความเมื่อตั้งค่า deleteTime

object (QuotedMessageMetadata)

เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับข้อความที่ยกมาโดยผู้ใช้ Google Chat ในพื้นที่ทำงาน ผู้ใช้ Google Chat จะยกข้อความมาตอบกลับได้

object (AttachedGif)

เอาต์พุตเท่านั้น รูปภาพ GIF ที่แนบมากับข้อความ

{
  "cardId": string,
  "card": {
    object (Card)
  }
}

string

ต้องระบุหากข้อความมีการ์ดหลายใบ ตัวระบุที่ไม่ซ้ำกันสำหรับการ์ดในข้อความ

object (Card)

การ์ด ขนาดสูงสุดคือ 32 KB

{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  }
  // End of list of possible types for union field metadata.
}

enum (AnnotationType)

ประเภทของคำอธิบายประกอบนี้

integer

ความยาวของสตริงย่อยในเนื้อหาข้อความธรรมดาที่สอดคล้องกับคำอธิบายประกอบนี้

integer

ดัชนีเริ่มต้น (แบบ 0, รวม) ในเนื้อหาข้อความธรรมดาที่คำอธิบายประกอบนี้เกี่ยวข้อง

object (UserMentionMetadata)

ข้อมูลเมตาของการพูดถึงผู้ใช้

object (SlashCommandMetadata)

ข้อมูลเมตาสำหรับคำสั่งเครื่องหมายทับ

{
  "user": {
    object (User)
  },
  "type": enum (Type)
}

object (User)

ผู้ใช้พูดถึง

enum (Type)

ประเภทของการพูดถึงผู้ใช้

{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}

object (User)

แอป Chat ที่มีการเรียกใช้คำสั่ง

enum (Type)

ประเภทของคําสั่งเครื่องหมายทับ

string

ชื่อของคำสั่งเครื่องหมายทับที่เรียกใช้

string (int64 format)

รหัสคำสั่งของคำสั่งเครื่องหมายทับที่เรียกใช้

boolean

ระบุว่าคําสั่งเครื่องหมายทับใช้สําหรับกล่องโต้ตอบหรือไม่

{
  "name": string,
  "threadKey": string
}

string

เอาต์พุตเท่านั้น ชื่อแหล่งข้อมูลของชุดข้อความ

เช่น spaces/{space}/threads/{thread}

string

ไม่บังคับ อินพุตสําหรับการสร้างหรืออัปเดตชุดข้อความ มิฉะนั้น เอาต์พุตอย่างเดียว รหัสสำหรับชุดข้อความ รองรับอักขระสูงสุด 4,000 ตัว

ซึ่งจะไม่ซ้ำกันในแอป Chat ที่ตั้งค่า ตัวอย่างเช่น หากแอป Chat หลายแอปสร้างข้อความโดยใช้คีย์ชุดข้อความเดียวกัน ระบบจะโพสต์ข้อความแบบแยกชุดข้อความ หากต้องการตอบกลับในชุดข้อความที่สร้างโดยบุคคลหรือแอป Chat อื่น ให้ระบุช่องชุดข้อความ name แทน

{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}

enum (ResponseType)

อินพุตเท่านั้น ประเภทการตอบกลับของแอป Chat

string

อินพุตเท่านั้น URL สำหรับให้ผู้ใช้ตรวจสอบสิทธิ์หรือกำหนดค่า (สำหรับคำตอบ REQUEST_CONFIG ประเภทเท่านั้น)

object (DialogAction)

อินพุตเท่านั้น การตอบกลับเหตุการณ์การโต้ตอบที่เกี่ยวข้องกับกล่องโต้ตอบ ต้องมี ResponseType.Dialog

object (UpdatedWidget)

อินพุตเท่านั้น การตอบสนองของวิดเจ็ตที่อัปเดต

{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}

object (ActionStatus)

อินพุตเท่านั้น สถานะคำขอในการเรียกใช้หรือส่งกล่องโต้ตอบ แสดงสถานะและข้อความให้ผู้ใช้ทราบ หากจำเป็น เช่น ในกรณีที่เกิดข้อผิดพลาดหรือสำเร็จ

object (Dialog)

อินพุตเท่านั้น กล่องโต้ตอบสำหรับคำขอ

{
  "body": {
    object (Card)
  }
}

object (Card)

อินพุตเท่านั้น เนื้อหาของกล่องโต้ตอบ ซึ่งแสดงผลในแบบโมดัล แอป Google Chat ไม่รองรับเอนทิตีของบัตรต่อไปนี้: DateTimePicker, OnChangeAction

{
  "statusCode": enum (Code),
  "userFacingMessage": string
}

enum (Code)

รหัสสถานะ

string

ข้อความที่จะส่งให้ผู้ใช้เกี่ยวกับสถานะของคำขอ หากไม่ได้ตั้งค่า ระบบจะส่งข้อความทั่วไปตาม statusCode

{
  "widget": string,

  // Union field updated_widget can be only one of the following:
  "suggestions": {
    object (SelectionItems)
  }
  // End of list of possible types for union field updated_widget.
}

string

รหัสของวิดเจ็ตที่อัปเดต รหัสต้องตรงกับรหัสสำหรับวิดเจ็ตที่ทริกเกอร์คำขออัปเดต

object (SelectionItems)

รายการผลลัพธ์ของการเติมข้อความอัตโนมัติของวิดเจ็ต

{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}

object (SelectionItem)

อาร์เรย์ของออบเจ็กต์ SelectionItem

{
  "commandId": string
}

string (int64 format)

รหัสของคำสั่งเครื่องหมายทับที่เรียกใช้

{
  "url": string
}

string

เอาต์พุตเท่านั้น URL ที่ตรงกัน

{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}

object (Emoji)

อีโมจิที่เชื่อมโยงกับความรู้สึก

integer

จำนวนรีแอ็กชันทั้งหมดที่ใช้อีโมจิที่เกี่ยวข้อง

{
  "deletionType": enum (DeletionType)
}

enum (DeletionType)

ระบุผู้ที่ลบข้อความ

{
  "name": string,
  "lastUpdateTime": string
}

string

เอาต์พุตเท่านั้น ชื่อแหล่งข้อมูลของข้อความที่ยกมา

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

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาเมื่อมีการสร้างข้อความที่ยกมาหรือเมื่อมีการอัปเดตข้อความที่ยกมาครั้งล่าสุด

{
  "uri": string
}

string

เอาต์พุตเท่านั้น URL ที่โฮสต์รูปภาพ GIF