- การแสดง JSON
- ExpectedInput
- InputPrompt
- SpeechResponse
- RichResponse
- รายการ
- SimpleResponse
- BasicCard
- ปุ่ม
- StructuredResponse
- OrderUpdate
- การดำเนินการ
- ใบเสร็จ
- RejectionInfo
- CancellationInfo
- InTransitInfo
- FulfillmentInfo
- ReturnInfo
- UserNotification
- MediaResponse
- MediaObject
- CarouselBrowse
- รายการ
- TableCard
- ColumnProperties
- แถว
- เซลล์
- HtmlResponse
- คำแนะนำ
- LinkOutSuggestion
- ExpectedIntent
- FinalResponse
- CustomPushMessage
- UserNotification
- เป้าหมาย
AppResponse คือคำตอบที่ Fulfillment ส่งให้ Google Assistant ดูตัวอย่างวิธีใช้งานใน Actions on Google ได้ที่ https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json#conversation-response-body
การแสดง JSON | |
---|---|
{ "conversationToken": string, "userStorage": string, "resetUserStorage": boolean, "expectUserResponse": boolean, "expectedInputs": [ { object ( |
ช่อง | |
---|---|
conversationToken |
โทเค็นทึบ ซึ่งจะหมุนเวียนไปยังการดำเนินการทุกๆ การสนทนา |
userStorage |
โทเค็นไม่ชัดเจนซึ่งควบคุมโดยการดำเนินการ ซึ่งจะมีอยู่ในการสนทนาของผู้ใช้รายหนึ่งๆ หากเว้นว่างไว้หรือไม่ได้ระบุ โทเค็นที่มีอยู่ซึ่งยังคงอยู่จะไม่มีการเปลี่ยนแปลง ขนาดสูงสุดของสตริงคือ 10 กิโลไบต์ หากมีกล่องโต้ตอบหลายรายการเกิดขึ้นพร้อมกันสำหรับผู้ใช้รายเดียวกัน การอัปเดตโทเค็นนี้สามารถเขียนทับกันได้โดยไม่คาดคิด |
resetUserStorage |
ต้องการล้าง userStorage ที่มีอยู่หรือไม่ หากตั้งค่าเป็น "จริง" ในการโต้ตอบกับผู้ใช้ครั้งถัดไป ช่อง userStorage จะว่างเปล่า |
expectUserResponse |
ระบุว่าการดำเนินการคาดหวังการตอบสนองจากผู้ใช้หรือไม่ ซึ่งจะเป็นเช่นนี้เมื่อการสนทนาดำเนินอยู่ และเป็น "เท็จ" เมื่อการสนทนาเสร็จสิ้น |
expectedInputs[] |
รายการอินพุตที่การดำเนินการคาดหวัง อินพุตแต่ละรายการอาจเป็นการดำเนินการทั่วไปใน Intent ของ Google (เริ่มต้นด้วย "actions") หรือรายการอินพุตที่ดำเนินการของ Intent ที่เป็นไปได้ ขณะนี้ระบบรองรับเฉพาะอินพุตเดียวเท่านั้น |
finalResponse |
การตอบกลับขั้นสุดท้ายเมื่อการดำเนินการไม่ได้ต้องการข้อมูลจากผู้ใช้ |
customPushMessage |
ข้อความ Push ที่กําหนดเองซึ่งช่วยให้นักพัฒนาแอปส่งข้อมูลที่มีโครงสร้างไปยังการดําเนินการใน Google ได้ |
isInSandbox |
ระบุว่าควรจัดการการตอบกลับในโหมดแซนด์บ็อกซ์หรือไม่ คุณจำเป็นต้องใช้บิตนี้เพื่อพุช Structured Data ไปยัง Google ในโหมดแซนด์บ็อกซ์ |
ExpectedInput
การแสดง JSON | |
---|---|
{ "inputPrompt": { object ( |
ช่อง | |
---|---|
inputPrompt |
พรอมต์ที่ปรับแต่งใช้ในการขอให้ผู้ใช้กรอกข้อมูล |
possibleIntents[] |
รายการ Intent ที่สามารถใช้เพื่อเติมอินพุตนี้ หากต้องการให้การดําเนินการใน Google แสดงข้อมูลดิบจากผู้ใช้ แอปควรขอ Intent |
speechBiasingHints[] |
รายการวลีที่การดำเนินการต้องการให้ Google ใช้เพื่อการให้น้ำหนักพิเศษกับเสียงพูด อนุญาตให้มีวลีไม่เกิน 1,000 วลี |
InputPrompt
ข้อความแจ้งอินพุตที่ใช้สำหรับ Assistant เพื่อช่วยแนะนําผู้ใช้ในการป้อนอินพุตสําหรับคําถามของแอป
การแสดง JSON | |
---|---|
{ "initialPrompts": [ { object ( |
ช่อง | |
---|---|
initialPrompts[] |
พรอมต์เริ่มต้นขอให้ผู้ใช้ป้อนข้อมูล รองรับ initial_prompt รายการเดียวเท่านั้น |
richInitialPrompt |
เพย์โหลดข้อความแจ้ง |
noInputPrompts[] |
พรอมต์ที่ใช้ถามผู้ใช้เมื่อไม่มีอินพุตจากผู้ใช้ |
SpeechResponse
คำตอบที่มีแต่เสียงพูด เลิกใช้งานแล้ว
การแสดง JSON | |
---|---|
{ // Union field |
ช่อง | ||
---|---|---|
ฟิลด์การรวม type ประเภทของเอาต์พุตเสียงพูด: การอ่านออกเสียงข้อความหรือ SSML type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
textToSpeech |
ข้อความธรรมดาของเอาต์พุตเสียงพูด เช่น "คุณอยากไปที่ไหน"/ |
|
ssml |
การตอบสนองด้วยเสียงพูดที่มีโครงสร้างกับผู้ใช้ในรูปแบบ SSML เช่น " |
RichResponse
คำตอบที่สมบูรณ์ซึ่งอาจรวมถึงเสียง ข้อความ การ์ด คำแนะนำ และข้อมูลที่มีโครงสร้าง
การแสดง JSON | |
---|---|
{ "items": [ { object ( |
ช่อง | |
---|---|
items[] |
รายการองค์ประกอบ UI ที่เขียนการตอบกลับ รายการต้องเป็นไปตามข้อกำหนดต่อไปนี้: 1. รายการแรกต้องเป็น |
suggestions[] |
รายการการตอบกลับที่แนะนำ ซึ่งจะปรากฏที่ท้ายคําตอบเสมอ หากใช้ใน |
linkOutSuggestion |
ชิปคำแนะนำเพิ่มเติมที่ลิงก์ออกไปยังแอปหรือเว็บไซต์ที่เกี่ยวข้องได้ |
รายการ
รายการคําตอบ
การแสดง JSON | |
---|---|
{ "name": string, // Union field |
ช่อง | ||
---|---|---|
name |
ตัวระบุที่มีชื่อ (ไม่บังคับ) ของรายการนี้ |
|
ฟิลด์การรวม item ประเภทของรายการ item ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
simpleResponse |
คำตอบด้วยเสียงและข้อความเท่านั้น |
|
basicCard |
บัตรพื้นฐาน |
|
structuredResponse |
เพย์โหลดที่มีโครงสร้างที่ Google จะประมวลผล |
|
mediaResponse |
คำตอบที่ระบุชุดสื่อที่จะเล่น |
|
carouselBrowse |
การ์ดเรียกดูภาพสไลด์ ใช้ collectionsBrowse แทน |
|
tableCard |
การ์ดตาราง |
|
htmlResponse |
การตอบสนอง Html ที่ใช้เพื่อแสดงผลบน Canvas |
SimpleResponse
คำตอบง่ายๆ มีคำพูดหรือข้อความที่จะแสดงให้ผู้ใช้เห็น
การแสดง JSON | |
---|---|
{ "textToSpeech": string, "ssml": string, "displayText": string } |
ช่อง | |
---|---|
textToSpeech |
ข้อความธรรมดาของเอาต์พุตเสียงพูด เช่น "คุณอยากไปที่ไหน" ใช้พร้อมกันไม่ได้ด้วย ssml |
ssml |
คำตอบที่เป็นคำพูดที่มีโครงสร้างสำหรับผู้ใช้ในรูปแบบ SSML เช่น |
displayText |
ข้อความที่ไม่บังคับที่จะแสดงในบับเบิลแชท หากไม่ได้ระบุไว้ ระบบจะใช้การแสดงผลข้อความการอ่านออกเสียงข้อความหรือ ssml ด้านบน จำกัดอักขระไม่เกิน 640 ตัว |
BasicCard
การ์ดพื้นฐานสำหรับการแสดงข้อมูลบางอย่าง เช่น รูปภาพและ/หรือข้อความ
การแสดง JSON | |
---|---|
{ "title": string, "subtitle": string, "formattedText": string, "image": { object ( |
ช่อง | |
---|---|
title |
ชื่อโดยรวมของการ์ด ไม่บังคับ |
subtitle |
ไม่บังคับ |
formattedText |
ข้อความเนื้อหาของการ์ด รองรับไวยากรณ์มาร์กดาวน์บางส่วนสำหรับการจัดรูปแบบ ต้องระบุ เว้นแต่จะมีรูปภาพ |
image |
รูปภาพหลักของการ์ด ความสูงกำหนดตายตัวที่ 192dp ไม่บังคับ |
buttons[] |
ปุ่ม ปัจจุบันระบบรองรับปุ่มไม่เกิน 1 ปุ่ม ไม่บังคับ |
imageDisplayOptions |
ประเภทการแสดงรูปภาพ ไม่บังคับ |
ปุ่ม
วัตถุปุ่มที่โดยปกติจะปรากฏที่ด้านล่างของการ์ด
การแสดง JSON | |
---|---|
{
"title": string,
"openUrlAction": {
object ( |
ช่อง | |
---|---|
title |
ชื่อของปุ่ม ต้องระบุ |
openUrlAction |
การทำงานเมื่อผู้ใช้แตะปุ่ม ต้องระบุ |
StructuredResponse
การตอบสนองที่กำหนดไว้เพื่อให้แอปตอบกลับด้วย Structured Data
การแสดง JSON | |
---|---|
{ // Union field |
ช่อง | ||
---|---|---|
ฟิลด์การรวม data คอนเทนเนอร์ของการตอบสนองเพย์โหลดจาก Agent 3P data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
orderUpdate |
แอปให้การอัปเดตคําสั่งซื้อ (เช่น |
|
orderUpdateV3 |
แอปให้การอัปเดตคำสั่งซื้อในรูปแบบ API v3 หลังจากได้รับคำสั่งซื้อ |
OrderUpdate
เลิกใช้งานแล้ว: ใช้ V3 Proto แทน อัปเดตเป็นคำสั่งซื้อ
การแสดง JSON | |
---|---|
{ "googleOrderId": string, "actionOrderId": string, "orderState": { object ( |
ช่อง | ||
---|---|---|
googleOrderId |
รหัสคําสั่งซื้อเป็นรหัสที่ Google ออกให้ |
|
actionOrderId |
ต้องระบุ รหัสคำสั่งซื้อ Canonical ที่อ้างอิงคำสั่งซื้อนี้ หากผู้รวมระบบไม่สร้างรหัสคำสั่งซื้อ Canonical ในระบบ ผู้ผสานการทำงานก็เพียงแค่คัดลอก googleOrderId ที่มีให้ตามลำดับ |
|
orderState |
สถานะใหม่ของคำสั่งซื้อ |
|
orderManagementActions[] |
อัปเดตการดำเนินการจัดการที่เกี่ยวข้องสำหรับคำสั่งซื้อ เช่น จัดการ แก้ไข ติดต่อฝ่ายสนับสนุน |
|
receipt |
ใบเสร็จสำหรับการสั่งซื้อ |
|
updateTime |
มีการอัปเดตคำสั่งซื้อจากมุมมองของแอปเมื่อใด การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: |
|
totalPrice |
ราคารวมใหม่ของคำสั่งซื้อ |
|
lineItemUpdates |
แผนที่การเปลี่ยนแปลงระดับรายการโฆษณา ซึ่งคีย์ตามรหัสรายการ ไม่บังคับ ออบเจ็กต์ที่มีรายการคู่ |
|
userNotification |
หากระบุไว้ จะแสดงการแจ้งเตือนแก่ผู้ใช้ที่มีชื่อและข้อความที่ระบุ การระบุการแจ้งเตือนเป็นคำแนะนำในการแจ้งเตือน และไม่รับประกันว่าจะมีการแจ้งเตือน |
|
infoExtension |
ข้อมูลเพิ่มเติมตามสถานะคำสั่งซื้อที่กำหนดเองหรือเพิ่มเติมจากข้อมูลสถานะมาตรฐาน ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
|
ฟิลด์การรวม info ข้อมูลเพิ่มเติมที่เกี่ยวข้องกับสถานะของคำสั่งซื้อ info ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
rejectionInfo |
ข้อมูลเกี่ยวกับสถานะการปฏิเสธ |
|
cancellationInfo |
ข้อมูลเกี่ยวกับสถานะการยกเลิก |
|
inTransitInfo |
ข้อมูลเกี่ยวกับสถานะการขนส่ง |
|
fulfillmentInfo |
ข้อมูลเกี่ยวกับสถานะการดำเนินการตามคำสั่งซื้อ |
|
returnInfo |
ข้อมูลเกี่ยวกับสถานะที่ส่งคืน |
การดำเนินการ
การดำเนินการติดตามผลที่เชื่อมโยงกับการอัปเดตคำสั่งซื้อ
การแสดง JSON | |
---|---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ประเภทการทำงาน |
button |
ป้ายกำกับและลิงก์ของปุ่ม |
ใบเสร็จ
เลิกใช้งานแล้ว: ใช้ V3 Proto แทน ใบเสร็จเมื่อสถานะได้รับการยืนยันหรือสถานะอื่นๆ (เช่น IN_TRANSIT, FULFILLED) รวมสถานะยืนยันแล้ว
การแสดง JSON | |
---|---|
{ "confirmedActionOrderId": string, "userVisibleOrderId": string } |
ช่อง | |
---|---|
confirmedActionOrderId |
ยืนยันรหัสคำสั่งซื้อเมื่อผู้รวมระบบได้รับคำสั่งซื้อ นี่คือรหัสคำสั่งซื้อ Canonical ที่ใช้ในระบบของผู้ผสานการทำงานที่อ้างอิงคำสั่งซื้อและอาจนำไปใช้เพื่อระบุคำสั่งซื้อเป็น โปรดทราบว่าช่องนี้เลิกใช้งานแล้ว โปรดส่งช่องนี้ผ่าน OrderUpdate.action_order_id แทน |
userVisibleOrderId |
ไม่บังคับ บัตรประจำตัวที่แสดงต่อผู้ใช้ซึ่งอ้างอิงถึงคำสั่งซื้อปัจจุบัน ซึ่งจะแสดงในการ์ดใบเสร็จ หากมี นี่ควรเป็นรหัสที่ปกติจะปรากฏบนใบเสร็จรับเงินที่พิมพ์ออกมาหรือใบเสร็จที่ส่งไปยังอีเมลของผู้ใช้ ผู้ใช้ควรใช้รหัสนี้อ้างอิงคำสั่งซื้อของตนสำหรับการบริการลูกค้าที่ผู้รวมบริการจัดหาให้ โปรดทราบว่าต้องป้อนข้อมูลในช่องนี้หากผู้ผสานการทำงานสร้างรหัสที่แสดงต่อผู้ใช้สำหรับคำสั่งซื้อที่มีใบเสร็จแบบพิมพ์ / ใบเสร็จทางอีเมล |
RejectionInfo
ข้อมูลการปฏิเสธเมื่อสถานะถูกปฏิเสธ ข้อความนี้สามารถสร้างขึ้นในการอัปเดตคำสั่งซื้อครั้งแรกในการสนทนา หรือผ่านการอัปเดตคำสั่งซื้อแบบไม่พร้อมกันในภายหลัง
การแสดง JSON | |
---|---|
{
"type": enum ( |
ช่อง | |
---|---|
type |
ประเภทการปฏิเสธ |
reason |
สาเหตุของข้อผิดพลาด |
CancellationInfo
เลิกใช้งานแล้ว: ใช้ V3 Proto แทน ข้อมูลการยกเลิกเมื่อสถานะถูกยกเลิก
การแสดง JSON | |
---|---|
{ "reason": string } |
ช่อง | |
---|---|
reason |
เหตุผลในการยกเลิก |
InTransitInfo
เลิกใช้งานแล้ว: ใช้ V3 Proto แทน ข้อมูลการขนส่งสาธารณะเมื่อรัฐคือ IN_TRANSIT
การแสดง JSON | |
---|---|
{ "updatedTime": string } |
ช่อง | |
---|---|
updatedTime |
เวลาที่อัปเดตล่าสุดสำหรับ ในการขนส่ง การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: |
FulfillmentInfo
เลิกใช้งานแล้ว: ใช้ V3 Proto แทน ข้อมูลการดำเนินการตามคำสั่งซื้อเมื่อสถานะเสร็จสมบูรณ์แล้ว
การแสดง JSON | |
---|---|
{ "deliveryTime": string } |
ช่อง | |
---|---|
deliveryTime |
เวลาที่ดำเนินการตามคำสั่งซื้อ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: |
ReturnInfo
เลิกใช้งานแล้ว: ใช้ V3 Proto แทน ข้อมูลการคืนสินค้าเมื่อสถานะถูกปฏิเสธ
การแสดง JSON | |
---|---|
{ "reason": string } |
ช่อง | |
---|---|
reason |
เหตุผลในการส่งคืนสินค้า |
UserNotification
การแจ้งเตือนผู้ใช้แบบไม่บังคับที่จะแสดงเป็นส่วนหนึ่งของการอัปเดตคำสั่งซื้อ
การแสดง JSON | |
---|---|
{ "title": string, "text": string } |
ช่อง | |
---|---|
title |
ชื่อของการแจ้งเตือนผู้ใช้ |
text |
เนื้อหาของการแจ้งเตือน |
MediaResponse
คำตอบที่ระบุชุดของสื่อที่จะเล่นภายในการสนทนา
การแสดง JSON | |
---|---|
{ "mediaType": enum ( |
ช่อง | |
---|---|
mediaType |
ประเภทสื่อภายในคําตอบนี้ |
mediaObjects[] |
รายการออบเจ็กต์สื่อ |
MediaObject
แสดงออบเจ็กต์สื่อ 1 รายการซึ่งแสดงผลพร้อม MediaResponse มีข้อมูลเกี่ยวกับสื่อ เช่น ชื่อ, คำอธิบาย, URL ฯลฯ
การแสดง JSON | |
---|---|
{ "name": string, "description": string, "contentUrl": string, // Union field |
ช่อง | ||
---|---|---|
name |
ชื่อของออบเจ็กต์สื่อนี้ |
|
description |
คำอธิบายของออบเจ็กต์สื่อนี้ |
|
contentUrl |
URL ที่ชี้ไปยังเนื้อหาสื่อ |
|
ฟิลด์การรวม image รูปภาพที่จะแสดงกับการ์ดสื่อ image ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
largeImage |
ภาพขนาดใหญ่ เช่น ปกอัลบั้ม ฯลฯ |
|
icon |
ไอคอนรูปภาพขนาดเล็กที่แสดงทางด้านขวาจากชื่อ มีขนาด 36x36 dp |
CarouselBrowse
แสดงชุดเอกสาร AMP เป็นภาพสไลด์ของรายการขนาดใหญ่ ระบบอาจเลือกรายการขึ้นมาแสดงเอกสาร AMP ที่เกี่ยวข้องในโปรแกรมเปิด AMP
การแสดง JSON | |
---|---|
{ "items": [ { object ( |
ช่อง | |
---|---|
items[] |
ต่ำสุด: 2. สูงสุด: 10 |
imageDisplayOptions |
ประเภทการแสดงรูปภาพ ไม่บังคับ |
รายการ
รายการในภาพสไลด์
การแสดง JSON | |
---|---|
{ "title": string, "description": string, "footer": string, "image": { object ( |
ช่อง | |
---|---|
title |
ชื่อของรายการภาพสไลด์ ต้องระบุ |
description |
คำอธิบายของรายการภาพสไลด์ ไม่บังคับ |
footer |
ข้อความส่วนท้ายสำหรับรายการภาพสไลด์ จะแสดงใต้คำอธิบาย ข้อความบรรทัดเดียวที่ตัดด้วยจุดไข่ปลา ไม่บังคับ |
image |
รูปภาพหลักของรายการภาพสไลด์ ไม่บังคับ |
openUrlAction |
URL ของเอกสารที่เชื่อมโยงกับรายการภาพสไลด์ เอกสารอาจมีเนื้อหา HTML หรือหากตั้งค่า "urlTypeHint" เป็น AMP_CONTENT ก็ให้แสดงเนื้อหา AMP ต้องระบุ |
TableCard
การ์ดตารางสำหรับแสดงตารางข้อความ
การแสดง JSON | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
ช่อง | |
---|---|
title |
ชื่อโดยรวมของตาราง ไม่บังคับ แต่ต้องตั้งค่าหากมีการตั้งค่าคำบรรยาย |
subtitle |
ชื่อรองของตาราง ไม่บังคับ |
image |
รูปภาพที่เชื่อมโยงกับตาราง ไม่บังคับ |
columnProperties[] |
ส่วนหัวและการจัดคอลัมน์ |
rows[] |
ข้อมูลแถวของตาราง ระบบรับประกันว่า 3 แถวแรกจะแสดง แต่แถวอื่นๆ อาจถูกตัดออกในบางพื้นผิว โปรดทดสอบด้วยเครื่องมือจำลองเพื่อดูว่าแถวใดจะแสดงขึ้นในพื้นผิวหนึ่งๆ บนแพลตฟอร์มที่รองรับความสามารถ WEB_BROWSER คุณสามารถนำผู้ใช้ไปยังหน้าเว็บที่มีข้อมูลเพิ่มเติมได้ |
buttons[] |
ปุ่ม ปัจจุบันระบบรองรับปุ่มไม่เกิน 1 ปุ่ม ไม่บังคับ |
ColumnProperties
เก็บคุณสมบัติของคอลัมน์ (รวมถึงส่วนหัว)
การแสดง JSON | |
---|---|
{
"header": string,
"horizontalAlignment": enum ( |
ช่อง | |
---|---|
header |
ข้อความส่วนหัวของคอลัมน์ |
horizontalAlignment |
การจัดข้อความแนวนอนของคอลัมน์เนื้อหา หากไม่ระบุ เนื้อหาจะอยู่ในแนวเดียวกับขอบที่ด้านหน้า |
แถว
อธิบายแถวในตาราง
การแสดง JSON | |
---|---|
{
"cells": [
{
object ( |
ช่อง | |
---|---|
cells[] |
เซลล์ในแถวนี้ ระบบรับประกันว่าเซลล์ 3 เซลล์แรกจะแสดง แต่เซลล์อื่นอาจถูกตัดในบางพื้นผิว โปรดทดสอบด้วยเครื่องมือจำลองเพื่อดูว่าเซลล์ใดจะแสดงสำหรับพื้นผิวที่ระบุ |
dividerAfter |
ระบุว่าควรมีตัวแบ่งหลังแต่ละแถวหรือไม่ |
เซลล์
อธิบายเซลล์ในแถว
การแสดง JSON | |
---|---|
{ "text": string } |
ช่อง | |
---|---|
text |
เนื้อหาข้อความของเซลล์ |
HtmlResponse
การตอบกลับที่แสดง HTML โดยใช้ฟีเจอร์ Canvas แบบอินเทอร์แอกทีฟ ขนาดสูงสุดของการตอบสนองคือ 50 กิโลไบต์
การแสดง JSON | |
---|---|
{ "updatedState": value, "suppressMic": boolean, "url": string } |
ช่อง | |
---|---|
updatedState |
สื่อสารออบเจ็กต์ JSON ต่อไปนี้กับแอป |
suppressMic |
โปรดระบุตัวเลือกเพื่อป้องกันไม่ให้ไมโครโฟนเปิดหลังจากการตอบสนองแบบสมจริงนี้ |
url |
URL ของแอปพลิเคชัน |
คำแนะนำ
ชิปคำแนะนำที่ผู้ใช้แตะเพื่อโพสต์ตอบการสนทนาได้อย่างรวดเร็ว
การแสดง JSON | |
---|---|
{ "title": string } |
ช่อง | |
---|---|
title |
ข้อความที่แสดงในชิปคำแนะนำ เมื่อแตะ ข้อความนี้จะถูกโพสต์กลับไปยังการสนทนาแบบคำต่อคำเหมือนกับว่าผู้ใช้ได้พิมพ์ข้อความลงไป ชื่อแต่ละชื่อต้องไม่ซ้ำกันในชุดชิปคำแนะนำ ต้องระบุอักขระสูงสุด 25 ตัว |
LinkOutSuggestion
สร้างชิปคำแนะนำที่ช่วยให้ผู้ใช้ข้ามไปยังแอปหรือเว็บไซต์ที่เชื่อมโยงกับตัวแทนนี้ได้
การแสดง JSON | |
---|---|
{
"destinationName": string,
"url": string,
"openUrlAction": {
object ( |
ช่อง | |
---|---|
destinationName |
ชื่อของแอปหรือเว็บไซต์ที่ชิปนี้ลิงก์อยู่ ชิปจะแสดงผลในชื่อ "เปิด |
url |
เลิกใช้งานแล้ว โปรดใช้ OpenUrlAction แทน |
openUrlAction |
URL ของแอปหรือเว็บไซต์ที่จะเปิดเมื่อผู้ใช้แตะชิปคำแนะนำ คุณจะต้องตรวจสอบการเป็นเจ้าของแอป/URL นี้ในการดําเนินการใน Google Developers Console มิฉะนั้นคําแนะนําจะไม่แสดงให้ผู้ใช้เห็น การดำเนินการ URL แบบเปิดรองรับ http, https และ URL ของ Intent สำหรับ URL ของ Intent โปรดดูที่ https://developer.chrome.com/multidevice/android/intents |
ExpectedIntent
เจตนาที่แอปขอให้ Assistant ระบุ
การแสดง JSON | |
---|---|
{ "intent": string, "inputValueData": { "@type": string, field1: ..., ... }, "parameterName": string } |
ช่อง | |
---|---|
intent |
ชื่อ Intent ในตัว เช่น |
inputValueData |
Intent ในตัวที่จำเป็นต้องระบุข้อมูลการกำหนดค่าเพิ่มเติม ค่าที่เป็นไปได้สำหรับ Intent ในตัว: ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
parameterName |
พารามิเตอร์ของ Intent ที่มีการขอ (ไม่บังคับ) ใช้ได้กับ Intent ที่ขอเท่านั้น ใช้สำหรับการให้น้ำหนักพิเศษกับเสียงพูด |
FinalResponse
การตอบสนองสุดท้ายเมื่อไม่คาดหวังข้อมูลจากผู้ใช้
การแสดง JSON | |
---|---|
{ // Union field |
ช่อง | ||
---|---|---|
ฟิลด์การรวม response ประเภทการตอบกลับที่เป็นไปได้ response ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
speechResponse |
พูดคำตอบเมื่อไม่จำเป็นต้องให้ผู้ใช้ป้อนข้อมูล |
|
richResponse |
การตอบสนองที่สมบูรณ์เมื่อผู้ใช้ไม่จำเป็นต้องป้อนข้อมูล |
CustomPushMessage
ข้อความพุชที่กำหนดเองซึ่งมีข้อมูลที่มีโครงสร้างเพื่อพุชการดำเนินการ Fulfillment API
การแสดง JSON | |
---|---|
{ "target": { object ( |
ช่อง | ||
---|---|---|
target |
เป้าหมายที่ระบุสำหรับคำขอพุช |
|
ฟิลด์การรวม content เพย์โหลดประเภทต่างๆ content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
orderUpdate |
การอัปเดตคำสั่งซื้อซึ่งอัปเดตคำสั่งซื้อที่ดำเนินการผ่าน API ธุรกรรม |
|
userNotification |
หากระบุไว้ จะแสดงการแจ้งเตือนแก่ผู้ใช้ที่มีชื่อและข้อความที่ระบุ |
UserNotification
การแจ้งเตือนผู้ใช้ที่จะแสดงพร้อมคำขอ
การแสดง JSON | |
---|---|
{ "title": string, "text": string } |
ช่อง | |
---|---|
title |
ชื่อของการแจ้งเตือน |
text |
เนื้อหาของการแจ้งเตือน |
เป้าหมาย
เป้าหมายที่ระบุสำหรับคำขอพุช
การแสดง JSON | |
---|---|
{
"userId": string,
"intent": string,
"argument": {
object ( |
ช่อง | |
---|---|
userId |
ผู้ใช้ที่จะกำหนดเป้าหมาย |
intent |
ความตั้งใจที่จะกำหนดเป้าหมาย |
argument |
อาร์กิวเมนต์ที่จะกำหนดเป้าหมายสำหรับ Intent สำหรับ V1 ระบบรองรับอาร์กิวเมนต์เพียงรายการเดียว |
locale |
ภาษาที่จะกำหนดเป้าหมาย เป็นไปตามรหัสภาษา IETF BCP-47 สามารถใช้โดยแอปหลายภาษาเพื่อกำหนดเป้าหมายผู้ใช้ในแอปที่แปลแล้วที่ระบุ หากไม่ระบุ ระบบจะใช้ค่าเริ่มต้นเป็น en-US |