REST Resource: phones.agentMessages

ทรัพยากร: AgentMessage

ข้อความที่ตัวแทนส่งถึงผู้ใช้

การแสดง JSON
{
  "name": string,
  "sendTime": string,
  "contentMessage": {
    object (AgentContentMessage)
  },
  "messageTrafficType": enum (MessageTrafficType),

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
ช่อง
name

string

แพลตฟอร์ม RBM เป็นผู้กำหนดช่องนี้ อย่าใส่เมื่อสร้างข้อความของตัวแทน ฟิลด์จะแปลง "phones/{E.164}/agentMessages/{messageId}" โดยที่ {E.164} คือหมายเลขโทรศัพท์ของผู้ใช้ในรูปแบบ E.164 และ {messageId} คือรหัสที่กำหนดโดยตัวแทนของข้อความตัวแทน

sendTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

contentMessage

object (AgentContentMessage)

เนื้อหาของข้อความตัวแทน

messageTrafficType

enum (MessageTrafficType)

ประเภทการเข้าชมข้อความ

ฟิลด์ Union expiration

expiration ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น

expireTime

string (Timestamp format)

ไม่บังคับ การประทับเวลาใน UTC ของเวลาที่ถือว่าทรัพยากรนี้หมดอายุ ค่านี้จะแสดงในเอาต์พุตหากมีการตั้งค่าไว้ หรือหากมีการตั้งค่าฟิลด์ TTL

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ttl

string (Duration format)

ไม่บังคับ อินพุตเท่านั้น ระยะเวลาที่ข้อความจะมีผลก่อนที่จะถูกเพิกถอนโดยอัตโนมัติ

ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"

AgentContentMessage

เนื้อหาของข้อความที่ตัวแทนส่งถึงผู้ใช้

การแสดง JSON
{
  "suggestions": [
    {
      object (Suggestion)
    }
  ],

  // Union field content can be only one of the following:
  "text": string,
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "richCard": {
    object (RichCard)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
ช่อง
suggestions[]

object (Suggestion)

รายการคำตอบที่แนะนำและการดำเนินการที่แนะนำซึ่งปรากฏเป็นรายการชิปคำแนะนำหลังข้อความของตัวแทนที่เกี่ยวข้อง คำแนะนำสูงสุด 11 รายการ

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

ฟิลด์ Union content เนื้อหาของข้อความจากตัวแทน content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
text

string

ข้อความที่เข้ารหัสใน UTF-8 ความยาวไม่เกิน 3,072 อักขระ

fileName
(deprecated)

string

ชื่อที่ไม่ซ้ำกันของไฟล์ แพลตฟอร์ม RBM จะแสดงชื่อไฟล์เมื่อตัวแทนอัปโหลดไฟล์ เลิกใช้งานแล้วและแนะนำให้ใช้ uploadedRbmFile ด้านล่างแทน

uploadedRbmFile

object (UploadedRbmFile)

มีตัวระบุสำหรับไฟล์และภาพขนาดย่อที่อัปโหลดไปยังเซิร์ฟเวอร์ RBM และแสดงโดยเซิร์ฟเวอร์ RBM

richCard

object (RichCard)

Rich Card แบบสแตนด์อโลน

contentInfo

object (ContentInfo)

ข้อมูลเกี่ยวกับไฟล์ ซึ่งรวมถึง URL ของไฟล์และ URL ของภาพขนาดย่อของไฟล์

แพลตฟอร์ม RBM แสดงเนื้อหาจากแคช แต่ตัวแทนสามารถบังคับให้แพลตฟอร์ม RBM ดึงเนื้อหาเวอร์ชันใหม่และรีเฟรชแคชได้

UploadedRbmFile

ข้อความที่มีข้อมูลไฟล์และภาพขนาดย่อ

การแสดง JSON
{
  "fileName": string,
  "thumbnailName": string
}
ช่อง
fileName

string

ชื่อของไฟล์ที่แพลตฟอร์ม RBM แสดงเมื่ออัปโหลดไฟล์

thumbnailName

string

ชื่อของภาพขนาดย่อที่แพลตฟอร์ม RBM แสดงเมื่อมีการอัปโหลดภาพขนาดย่อ

RichCard

การ์ดริชมีเดียแบบสแตนด์อโลนหรือภาพหมุนของการ์ดริชมีเดียที่เอเจนต์ส่งให้ผู้ใช้

การแสดง JSON
{

  // Union field card can be only one of the following:
  "carouselCard": {
    object (CarouselCard)
  },
  "standaloneCard": {
    object (StandaloneCard)
  }
  // End of list of possible types for union field card.
}
ช่อง
ฟิลด์ Union card การ์ดแบบสแตนด์อโลนหรือภาพสไลด์การ์ด card ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
carouselCard

object (CarouselCard)

ภาพสไลด์ของการ์ด

standaloneCard

object (StandaloneCard)

การ์ดแบบสแตนด์อโลน

CarouselCard

ภาพสไลด์ของการ์ด

การแสดง JSON
{
  "cardWidth": enum (CarouselCard.CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}
ช่อง
cardWidth

enum (CarouselCard.CardWidth)

ความกว้างของการ์ดในภาพสไลด์

cardContents[]

object (CardContent)

รายการเนื้อหาของการ์ดแต่ละใบในภาพสไลด์ ภาพสไลด์มีได้ขั้นต่ำ 2 การ์ดและสูงสุด 10 การ์ด

CarouselCard.CardWidth

ความกว้างของการ์ดในภาพสไลด์

Enum
CARD_WIDTH_UNSPECIFIED ไม่ได้ระบุ
SMALL 120 DP โปรดทราบว่าคุณจะใช้สื่อแนวตั้งไม่ได้
MEDIUM 232 DP.

CardContent

เนื้อหาของการ์ด

การแสดง JSON
{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}
ช่อง
title

string

(ไม่บังคับ) ชื่อของการ์ด สูงสุด 200 อักขระ

description

string

(ไม่บังคับ) คำอธิบายของการ์ด สูงสุด 2,000 อักขระ

media

object (Media)

(ไม่บังคับ) สื่อ (รูปภาพ, GIF, วิดีโอ, PDF) ที่จะรวมไว้ในการ์ด

suggestions[]

object (Suggestion)

(ไม่บังคับ) รายการคำแนะนำที่จะรวมไว้ในการ์ด แนะนำได้สูงสุด 4 รายการ

สื่อ

ไฟล์สื่อภายใน Rich Card

การแสดง JSON
{
  "height": enum (Media.Height),

  // Union field content can be only one of the following:
  "fileName": string,
  "uploadedRbmFile": {
    object (UploadedRbmFile)
  },
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}
ช่อง
height

enum (Media.Height)

ความสูงของสื่อภายใน Rich Card ที่มีเลย์เอาต์แนวตั้ง สำหรับบัตรแบบสแตนด์อโลนที่มีเลย์เอาต์แนวนอน คุณจะปรับแต่งความสูงไม่ได้ และระบบจะไม่สนใจช่องนี้

ฟิลด์ Union content เนื้อหาสื่อ content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
fileName
(deprecated)

string

ชื่อที่ไม่ซ้ำกันของไฟล์ ซึ่งแพลตฟอร์ม RBM จะแสดงเมื่ออัปโหลดไฟล์ เลิกใช้งานแล้วและแนะนำให้ใช้ uploadedRbmFile ด้านล่างแทน

uploadedRbmFile

object (UploadedRbmFile)

มีตัวระบุสำหรับไฟล์และภาพขนาดย่อที่อัปโหลดไปยังเซิร์ฟเวอร์ RBM และแสดงโดยเซิร์ฟเวอร์ RBM

contentInfo

object (ContentInfo)

ข้อมูลเกี่ยวกับไฟล์ ซึ่งรวมถึง URL ของไฟล์และ URL ของภาพขนาดย่อของไฟล์

แพลตฟอร์ม RBM แสดงเนื้อหาจากแคช แต่ตัวแทนสามารถบังคับให้แพลตฟอร์ม RBM ดึงเนื้อหาเวอร์ชันใหม่และรีเฟรชแคชได้

ContentInfo

ข้อความที่มีข้อมูลเนื้อหา

การแสดง JSON
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean
}
ช่อง
fileUrl

string

URL ของไฟล์ที่เข้าถึงได้แบบสาธารณะ แพลตฟอร์ม RBM จะกำหนดประเภท MIME ของไฟล์จากฟิลด์ Content-Type ในส่วนหัว HTTP เมื่อแพลตฟอร์มดึงข้อมูลไฟล์ ฟิลด์ Content-Type ต้องมีอยู่และถูกต้องในการตอบกลับ HTTP จาก URL ขนาดไฟล์สูงสุดที่แนะนำคือ 100 MB

หมายเหตุ: ระบบไม่รองรับการเปลี่ยนเส้นทางใน URL ของไฟล์ โปรดใช้ CreateFileRequest หากจำเป็นต้องเปลี่ยนเส้นทาง

thumbnailUrl

string

(ไม่บังคับ สำหรับไฟล์รูปภาพ เสียง และวิดีโอเท่านั้น) URL ของภาพขนาดย่อที่เข้าถึงได้แบบสาธารณะ ขนาดสูงสุด 100 KB

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

หมายเหตุ: ระบบไม่รองรับการเปลี่ยนเส้นทางใน URL ของไฟล์ โปรดใช้ CreateFileRequest หากจำเป็นต้องเปลี่ยนเส้นทาง

forceRefresh

boolean

หากตั้งค่าไว้ แพลตฟอร์ม RBM จะดึงข้อมูลไฟล์และภาพขนาดย่อจาก URL ที่ระบุ แม้ว่าแพลตฟอร์มจะมีสำเนาไฟล์ (และ/หรือภาพขนาดย่อ) ที่แคชไว้ก็ตาม

Media.Height

ความสูงของสื่อ

Enum
HEIGHT_UNSPECIFIED ไม่ได้ระบุ
SHORT 112 DP
MEDIUM 168 DP
TALL 264 DP ใช้ไม่ได้กับภาพสไลด์ของการ์ดริชเมื่อตั้งค่าความกว้างของการ์ดเป็น "เล็ก"

คำแนะนำ

การตอบกลับที่แนะนำหรือการดำเนินการที่แนะนำซึ่งรวมอยู่ในการ์ด Rich หรือภายในรายการชิปคำแนะนำ

การแสดง JSON
{

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  }
  // End of list of possible types for union field option.
}
ช่อง
ฟิลด์ Union option คำตอบที่แนะนำหรือการดำเนินการที่แนะนำ option ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
reply

object (SuggestedReply)

ผู้ใช้สามารถแตะคำตอบที่แนะนำเพื่อส่งข้อความตอบกลับไปยังตัวแทน

action

object (SuggestedAction)

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

SuggestedReply

เมื่อแตะแล้ว ระบบจะส่งข้อความตอบกลับไปยังตัวแทน

การแสดง JSON
{
  "text": string,
  "postbackData": string
}
ช่อง
text

string

ข้อความที่แสดงในการตอบกลับที่แนะนำและส่งกลับไปยังตัวแทนเมื่อผู้ใช้แตะข้อความนั้น สูงสุด 25 อักขระ

postbackData

string

เพย์โหลดที่เข้ารหัส base64 ซึ่งเอเจนต์ได้รับในเหตุการณ์ของผู้ใช้เมื่อผู้ใช้แตะการตอบกลับที่แนะนำ

SuggestedAction

เมื่อแตะแล้ว จะเริ่มการดำเนินการดั้งเดิมที่เกี่ยวข้องในอุปกรณ์

การแสดง JSON
{
  "text": string,
  "postbackData": string,
  "fallbackUrl": string,

  // Union field action can be only one of the following:
  "dialAction": {
    object (DialAction)
  },
  "viewLocationAction": {
    object (ViewLocationAction)
  },
  "createCalendarEventAction": {
    object (CreateCalendarEventAction)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "shareLocationAction": {
    object (ShareLocationAction)
  }
  // End of list of possible types for union field action.
}
ช่อง
text

string

ข้อความที่แสดงในการดำเนินการที่แนะนำ สูงสุด 25 อักขระ

postbackData

string

เพย์โหลด (เข้ารหัส base64) ที่จะส่งไปยังตัวแทนในเหตุการณ์ของผู้ใช้ซึ่งเกิดขึ้นเมื่อผู้ใช้แตะการดำเนินการที่แนะนำ ยาวไม่เกิน 2,048 อักขระ

fallbackUrl

string

(ไม่บังคับ) URL สำรองที่จะใช้หากไคลเอ็นต์ไม่รองรับการดำเนินการที่แนะนำ URL สำรองจะเปิดในหน้าต่างเบราว์เซอร์ใหม่ ต้องเป็น URI ที่ถูกต้องตามที่กำหนดไว้ใน RFC 3986 ยาวไม่เกิน 2,048 อักขระ

ฟิลด์ Union action การดำเนินการดั้งเดิมที่เริ่มต้นในอุปกรณ์เมื่อผู้ใช้แตะการดำเนินการที่แนะนำ action จะเป็นอย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
dialAction

object (DialAction)

เปิดแอปแป้นโทรศัพท์เริ่มต้นของผู้ใช้พร้อมกรอกหมายเลขโทรศัพท์ที่ตัวแทนระบุ

viewLocationAction

object (ViewLocationAction)

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

createCalendarEventAction

object (CreateCalendarEventAction)

เปิดแอปปฏิทินเริ่มต้นของผู้ใช้และเริ่มขั้นตอนกิจกรรมในปฏิทินใหม่โดยมีข้อมูลกิจกรรมที่ตัวแทนระบุไว้ล่วงหน้า

openUrlAction

object (OpenUrlAction)

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

shareLocationAction

object (ShareLocationAction)

เปิดตัวเลือกตำแหน่งของแอป RCS เพื่อให้ผู้ใช้เลือกตำแหน่งที่จะส่งให้ตัวแทนได้

DialAction

เปิดแอปแป้นโทรศัพท์เริ่มต้นของผู้ใช้พร้อมกรอกหมายเลขโทรศัพท์ที่ตัวแทนระบุ

การแสดง JSON
{
  "phoneNumber": string
}
ช่อง
phoneNumber

string

หมายเลขโทรศัพท์ในรูปแบบ E.164 เช่น +12223334444

ViewLocationAction

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

การแสดง JSON
{
  "latLong": {
    object (LatLng)
  },
  "label": string,
  "query": string
}
ช่อง
latLong

object (LatLng)

(ไม่บังคับ) ละติจูดและลองจิจูดของสถานที่ที่ระบุ

label

string

(ไม่บังคับ) ป้ายกำกับของหมุดที่วางที่ latLong

query

string

(ไม่บังคับ รองรับเฉพาะในไคลเอ็นต์ Android Messages) ตัวแทนสามารถระบุสตริงการค้นหาแทนการระบุ latLong (และป้ายกำกับที่ไม่บังคับ) ได้ สำหรับแอปแผนที่เริ่มต้นที่รองรับฟังก์ชันการค้นหา (รวมถึง Google Maps) การแตะการดำเนินการที่แนะนำนี้จะทำให้ระบบค้นหาสถานที่โดยมีตำแหน่งปัจจุบันของผู้ใช้เป็นศูนย์กลาง หากคำค้นหามีความเฉพาะเจาะจงเพียงพอ เจ้าหน้าที่จะใช้คำค้นหานั้นเพื่อเลือกสถานที่ใดก็ได้ในโลก

เช่น การตั้งค่าสตริงการค้นหาเป็น "Growing Tree Bank" จะแสดงสถานที่ตั้งทั้งหมดของ Growing Tree Bank ในบริเวณใกล้เคียงของผู้ใช้ การตั้งค่าสตริงการค้นหาเป็น "1600 Amphitheater Parkway, Mountain View, CA 94043" จะเลือกที่อยู่นั้นโดยเฉพาะ ไม่ว่าผู้ใช้จะอยู่ที่ใดก็ตาม

LatLng

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

การแสดง JSON
{
  "latitude": number,
  "longitude": number
}
ช่อง
latitude

number

ละติจูดเป็นองศา ต้องอยู่ในช่วง [-90.0, +90.0]

longitude

number

ลองจิจูดในหน่วยองศา ต้องอยู่ในช่วง [-180.0, +180.0]

CreateCalendarEventAction

เปิดแอปปฏิทินเริ่มต้นของผู้ใช้และเริ่มขั้นตอนกิจกรรมในปฏิทินใหม่โดยมีข้อมูลกิจกรรมที่ตัวแทนระบุไว้ล่วงหน้า

การแสดง JSON
{
  "startTime": string,
  "endTime": string,
  "title": string,
  "description": string
}
ช่อง
startTime

string (Timestamp format)

เวลาเริ่มกิจกรรม

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

endTime

string (Timestamp format)

เวลาสิ้นสุดกิจกรรม

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

title

string

ชื่อกิจกรรม ยาวไม่เกิน 100 อักขระ

description

string

คำอธิบายกิจกรรม สูงสุด 500 อักขระ

OpenUrlAction

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

การแสดง JSON
{
  "url": string,
  "application": enum (OpenUrlApplication),
  "webviewViewMode": enum (WebviewViewMode),
  "description": string
}
ช่อง
url

string

URL ที่จะเปิด ตั้งแต่วันที่ 1 พฤศจิกายน 2025 เป็นต้นไป รูปแบบ URL ต้องเป็น https:// หรือ http:// คำขอ API ที่ใช้รูปแบบอื่น (เช่น tel:, mailto:, sms:) จะถูกปฏิเสธโดยมีข้อผิดพลาด 400 Bad Request หลังจากวันที่นี้ URL ต้องเป็น URI ที่ถูกต้องตามที่กำหนดไว้ใน RFC 3986 ยาวไม่เกิน 2,048 อักขระ

application

enum (OpenUrlApplication)

URL เปิดแอปพลิเคชัน เบราว์เซอร์ หรือ WebView หากต้องการตรวจสอบว่าอุปกรณ์ของผู้ใช้รองรับโหมด WebView หรือไม่ ให้เรียกใช้การตรวจสอบความสามารถก่อน ดูรายละเอียดได้ที่เอกสารประกอบ https://developers.google.com/business-communications/rcs-business-messaging/guides/build/capabilities

webviewViewMode

enum (WebviewViewMode)

โหมดมุมมองสำหรับ WebView

description

string

คำอธิบายการช่วยเหลือพิเศษสำหรับ WebView

OpenUrlApplication

ประเภทของแอปพลิเคชันที่เปิด URL

Enum
OPEN_URL_APPLICATION_UNSPECIFIED ไม่ได้ระบุ จะใช้เบราว์เซอร์เพื่อเปิด
BROWSER ใช้เบราว์เซอร์เพื่อเปิด URL
WEBVIEW เปิด URL ในหน้าต่าง WebView แบบผสานรวม

WebviewViewMode

ประเภทของโหมดการดูของ WebView

Enum
WEBVIEW_VIEW_MODE_UNSPECIFIED ไม่ได้ระบุ หากต้องการใช้ WebView คุณต้องระบุโหมดการดู
FULL ต้องมีภาพซ้อนทับแบบเต็มหน้าจอพร้อมการสนทนากับแชทบ็อตที่มีป้ายกำกับในแถบสถานะ
HALF ต้องใช้การซ้อนทับครึ่งหน้าจอ
TALL ต้องใช้การซ้อนทับหน้าจอ 3/4

ShareLocationAction

ประเภทนี้ไม่มีฟิลด์

เปิดตัวเลือกตำแหน่งของแอป RCS เพื่อให้ผู้ใช้เลือกตำแหน่งที่จะส่งกลับไปให้ตัวแทนได้

StandaloneCard

การ์ดแบบสแตนด์อโลน

การแสดง JSON
{
  "cardOrientation": enum (StandaloneCard.CardOrientation),
  "thumbnailImageAlignment": enum (StandaloneCard.ThumbnailImageAlignment),
  "cardContent": {
    object (CardContent)
  }
}
ช่อง
cardOrientation

enum (StandaloneCard.CardOrientation)

การวางแนวของการ์ด

thumbnailImageAlignment

enum (StandaloneCard.ThumbnailImageAlignment)

การจัดแนวตัวอย่างรูปภาพสําหรับการ์ดแบบสแตนด์อโลนที่มีเลย์เอาต์แนวนอน

cardContent

object (CardContent)

เนื้อหาของการ์ด

StandaloneCard.CardOrientation

การวางแนวของการ์ด

Enum
CARD_ORIENTATION_UNSPECIFIED ไม่ได้ระบุ
HORIZONTAL

เลย์เอาต์แนวนอน

หาก object(CardContent) ของริชการ์ดแนวนอนมีฟิลด์ media ก็ต้องมีฟิลด์ title, description หรือ suggestions[] อย่างน้อย 1 รายการด้วย

VERTICAL เลย์เอาต์แนวตั้ง

StandaloneCard.ThumbnailImageAlignment

การจัดแนวตัวอย่างรูปภาพสําหรับการ์ดแบบสแตนด์อโลนที่มีเลย์เอาต์แนวนอน

Enum
THUMBNAIL_IMAGE_ALIGNMENT_UNSPECIFIED ไม่ได้ระบุ
LEFT ตัวอย่างไฟล์จะอยู่ชิดซ้าย
RIGHT ตัวอย่างไฟล์จะอยู่ชิดขวา

MessageTrafficType

ประเภทการรับส่งข้อความที่รองรับ เราจะขยายการแจงนับเพื่อรองรับการเข้าชมประเภทอื่นๆ

Enum
MESSAGE_TRAFFIC_TYPE_UNSPECIFIED ลักษณะการทำงานเริ่มต้น: ประเภทการเข้าชมข้อความจะกำหนดโดยกรณีการใช้งานของตัวแทน อัปเดตประเภทการเข้าชมตามต้องการโดยอิงตามเนื้อหาของข้อความ สำหรับตัวแทนแบบหลายการใช้งาน จะไม่มีค่าเริ่มต้น ต้องตั้งค่าประเภทการเข้าชมด้วยตนเอง (เช่น ธุรกรรม โปรโมชัน)
AUTHENTICATION สำหรับข้อความการตรวจสอบสิทธิ์ในกรณีการใช้งานตัวแทน OTP
TRANSACTION สำหรับข้อความธุรกรรมในกรณีการใช้งานตัวแทนแบบธุรกรรมหรือแบบหลายครั้ง
PROMOTION สำหรับข้อความโปรโมชันในกรณีการใช้งานเอเจนต์แบบโปรโมชันหรือแบบหลายการใช้งาน
SERVICEREQUEST สำหรับข้อความเกี่ยวกับบริการที่ผู้ใช้ยินยอมรับ ใช้ในกรณีการใช้งาน OTP, ธุรกรรม, โปรโมชัน หรือตัวแทนแบบหลายการใช้งาน
ACKNOWLEDGEMENT สำหรับข้อความที่รับทราบคำขอยกเลิกการสมัครรับอีเมลของผู้ใช้ ใช้ในกรณีการใช้งาน OTP, ธุรกรรม, โปรโมชัน หรือตัวแทนแบบหลายการใช้งาน

เมธอด

create

ส่งข้อความจากตัวแทนไปยังผู้ใช้

delete

เพิกถอนข้อความของตัวแทนที่ส่งแล้วแต่ยังไม่ได้นำส่ง