AppResponse

AppResponse เป็นคำตอบที่ได้รับจากการดำเนินการตามคำสั่งซื้อไปยัง 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 (ExpectedInput)
    }
  ],
  "finalResponse": {
    object (FinalResponse)
  },
  "customPushMessage": {
    object (CustomPushMessage)
  },
  "isInSandbox": boolean
}
ช่อง
conversationToken

string

โทเค็นทึบแสงซึ่งหมุนเวียนไปที่การดำเนินการเมื่อบทสนทนาเปลี่ยนไป
userStorage

string

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

boolean

เลือกว่าจะล้างพื้นที่เก็บข้อมูลของผู้ใช้หรือไม่ หากตั้งค่าเป็น "จริง" ช่อง userStorage จะว่างเปล่าในการโต้ตอบกับผู้ใช้ครั้งถัดไป
expectUserResponse

boolean

ระบุว่าการดำเนินการนี้คาดว่าจะได้รับคำตอบจากผู้ใช้หรือไม่ กรณีนี้จะเป็นจริงเมื่อการสนทนาดำเนินอยู่ เป็นเท็จ เมื่อการสนทนาเสร็จสิ้น
expectedInputs[]

object (ExpectedInput)

รายการอินพุตที่ Action คาดหวัง อินพุตแต่ละรายการอาจเป็นการดำเนินการทั่วไปใน Intent ของ Google (เริ่มต้นด้วย "actions") หรืออินพุตที่แสดงรายการ Intent ที่เป็นไปได้ ระบบรองรับเฉพาะอินพุตเพียง 1 รายการในขณะนี้
finalResponse

object (FinalResponse)

การตอบกลับครั้งสุดท้ายเมื่อการดำเนินการไม่ได้คาดหวังข้อมูลจากผู้ใช้
customPushMessage

object (CustomPushMessage)

ข้อความพุชที่กำหนดเองซึ่งอนุญาตให้นักพัฒนาแอปส่งข้อมูลที่มีโครงสร้างไปยังการดำเนินการต่างๆ ใน Google
isInSandbox

boolean

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

ExpectedInput

การแสดง JSON 
{
  "inputPrompt": {
    object (InputPrompt)
  },
  "possibleIntents": [
    {
      object (ExpectedIntent)
    }
  ],
  "speechBiasingHints": [
    string
  ]
}
ช่อง
inputPrompt

object (InputPrompt)

ข้อความแจ้งแบบกำหนดเองซึ่งใช้เพื่อขอข้อมูลจากผู้ใช้
possibleIntents[]

object (ExpectedIntent)

รายการ Intent ที่ใช้เพื่อดำเนินการตามอินพุตนี้ได้ หากต้องการให้มีการดำเนินการใน Google เพียงส่งกลับอินพุตดิบของผู้ใช้ แอปควรขอ Intent ของ actions.intent.TEXT
speechBiasingHints[]

string

รายการวลีที่การดำเนินการนี้ต้องการให้ Google ใช้เพื่อให้น้ำหนักคำพูด มีวลีได้ไม่เกิน 1,000 รายการ

InputPrompt

พรอมต์อินพุตที่ใช้สำหรับ Assistant เพื่อแนะนำให้ผู้ใช้ป้อนข้อมูลสำหรับคำถามของแอป

การแสดง JSON 
{
  "initialPrompts": [
    {
      object (SpeechResponse)
    }
  ],
  "richInitialPrompt": {
    object (RichResponse)
  },
  "noInputPrompts": [
    {
      object (SimpleResponse)
    }
  ]
}
ช่อง
initialPrompts[]
(deprecated)

object (SpeechResponse)

ข้อความแจ้งขั้นต้นขอให้ผู้ใช้ป้อนข้อมูล รองรับ default_prompt เพียงครั้งเดียว
richInitialPrompt

object (RichResponse)

เพย์โหลด Prompt
noInputPrompts[]

object (SimpleResponse)

ข้อความแจ้งที่ใช้ถามผู้ใช้เมื่อไม่มีอินพุตจากผู้ใช้

SpeechResponse

คำตอบที่มีเฉพาะเสียงพูด เลิกใช้งานแล้ว

การแสดง JSON 
{

  // Union field type can be only one of the following:
  "textToSpeech": string,
  "ssml": string
  // End of list of possible types for union field type.
}
ช่อง
ช่องการรวม type ประเภทของเอาต์พุตเสียงพูด: การอ่านออกเสียงข้อความหรือ SSML type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
textToSpeech

string

ข้อความธรรมดาของเอาต์พุตเสียงพูด เช่น "คุณอยากไปที่ไหน"/
ssml

string

คำตอบของผู้ใช้อย่างมีโครงสร้างในรูปแบบ SSML เช่น " พูดชื่อสัตว์หลังได้ยินเสียง " พิเศษพร้อมกันด้วยการอ่านออกเสียงข้อความ

RichResponse

การตอบกลับที่สมบูรณ์อาจรวมถึงเสียง ข้อความ การ์ด คำแนะนำ และข้อมูลที่มีโครงสร้าง

การแสดง JSON 
{
  "items": [
    {
      object (Item)
    }
  ],
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "linkOutSuggestion": {
    object (LinkOutSuggestion)
  }
}
ช่อง
items[]

object (Item)

รายการองค์ประกอบ UI ที่เขียนการตอบกลับ รายการต้องเป็นไปตามข้อกำหนดต่อไปนี้: 1. รายการแรกต้องเป็น SimpleResponse 2 ไม่เกิน 2 SimpleResponse 3 รายการตอบกลับที่เป็นริชมีเดียไม่เกิน 1 รายการ (เช่น BasicCard, StructuredResponse, MediaResponse หรือ HtmlResponse) 4. คุณจะใช้รายการตอบกลับที่เป็นสื่อสมบูรณ์ไม่ได้หากใช้ actions.intent.OPTION Intent เช่น ListSelect หรือ CarouselSelect
suggestions[]

object (Suggestion)

รายการคำตอบที่แนะนำ ซึ่งจะแสดงท้ายคำตอบเสมอ หากใช้ใน FinalResponse ระบบจะไม่สนใจพารามิเตอร์ดังกล่าว

รายการ

รายการคำตอบ

การแสดง JSON 
{
  "name": string,

  // Union field item can be only one of the following:
  "simpleResponse": {
    object (SimpleResponse)
  },
  "basicCard": {
    object (BasicCard)
  },
  "structuredResponse": {
    object (StructuredResponse)
  },
  "mediaResponse": {
    object (MediaResponse)
  },
  "carouselBrowse": {
    object (CarouselBrowse)
  },
  "tableCard": {
    object (TableCard)
  },
  "htmlResponse": {
    object (HtmlResponse)
  }
  // End of list of possible types for union field item.
}
ช่อง
name

string

ตัวระบุที่มีชื่อ (ไม่บังคับ) ของรายการนี้
ช่องการรวม item ประเภทของรายการ item ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
simpleResponse

object (SimpleResponse)

ตอบด้วยเสียงและข้อความเท่านั้น
basicCard

object (BasicCard)

บัตรพื้นฐาน
structuredResponse

object (StructuredResponse)

เพย์โหลดที่มีโครงสร้างที่ Google จะประมวลผล
mediaResponse

object (MediaResponse)

การตอบกลับที่ระบุชุดสื่อที่จะเล่น
carouselBrowse

object (CarouselBrowse)

การ์ดเรียกดูภาพหมุน โปรดใช้คอลเล็กชันเรียกดูแทน
tableCard

object (TableCard)

การ์ดตาราง
htmlResponse

object (HtmlResponse)

การตอบกลับ HTML ที่ใช้แสดงผลบน Canvas

SimpleResponse

คำตอบง่ายๆ ที่มีคำพูดหรือข้อความที่จะแสดงให้ผู้ใช้เห็น

การแสดง JSON 
{
  "textToSpeech": string,
  "ssml": string,
  "displayText": string
}
ช่อง
textToSpeech

string

ข้อความธรรมดาของเอาต์พุตเสียงพูด เช่น "คุณอยากไปที่ไหน" มีความพิเศษร่วมกับ ssml
ssml

string

คำตอบของผู้ใช้อย่างมีโครงสร้างในรูปแบบ SSML เช่น <speak> Say animal name after the sound. <audio src = 'https://www.pullstring.com/moo.mps' />, what’s the animal? </speak> พิเศษพร้อมกันด้วยการอ่านออกเสียงข้อความ
displayText

string

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

BasicCard

การ์ดพื้นฐานสำหรับแสดงข้อมูลบางอย่าง เช่น รูปภาพและ/หรือข้อความ

การแสดง JSON 
{
  "title": string,
  "subtitle": string,
  "formattedText": string,
  "image": {
    object (Image)
  },
  "buttons": [
    {
      object (Button)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}
ช่อง
title

string

ชื่อโดยรวมของการ์ด ไม่บังคับ
subtitle

string

ไม่บังคับ
formattedText

string

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

object (Image)

รูปภาพหลักของการ์ด ความสูงกำหนดไว้ที่ 192dp ไม่บังคับ
buttons[]

object (Button)

ปุ่ม ขณะนี้รองรับเพียง 1 ปุ่มเท่านั้น ไม่บังคับ
imageDisplayOptions

enum (ImageDisplayOptions)

ประเภทการแสดงรูปภาพ ไม่บังคับ

ปุ่ม

วัตถุปุ่มที่ปกติจะปรากฏที่ด้านล่างของการ์ด

การแสดง JSON 
{
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
ช่อง
title

string

ชื่อของปุ่ม ต้องระบุ
openUrlAction

object (OpenUrlAction)

การดำเนินการที่จะทำเมื่อผู้ใช้แตะปุ่ม ต้องระบุ

StructuredResponse

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

การแสดง JSON 
{

  // Union field data can be only one of the following:
  "orderUpdate": {
    object (OrderUpdate)
  },
  "orderUpdateV3": {
    object (OrderUpdate)
  }
  // End of list of possible types for union field data.
}
ช่อง
ช่องการรวม data คอนเทนเนอร์การตอบสนองของเพย์โหลดจาก Agent 3P data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
orderUpdate

object (OrderUpdate)

แอปให้การอัปเดตคำสั่งซื้อ (เช่น Receipt) หลังจากได้รับคำสั่งซื้อ
orderUpdateV3

object (OrderUpdate)

แอปให้การอัปเดตคำสั่งซื้อในรูปแบบ API v3 หลังจากได้รับคำสั่งซื้อ

OrderUpdate

เลิกใช้งานแล้ว: ใช้ Proto V3 แทน การอัปเดตคำสั่งซื้อ

การแสดง JSON 
{
  "googleOrderId": string,
  "actionOrderId": string,
  "orderState": {
    object (OrderState)
  },
  "orderManagementActions": [
    {
      object (Action)
    }
  ],
  "receipt": {
    object (Receipt)
  },
  "updateTime": string,
  "totalPrice": {
    object (Price)
  },
  "lineItemUpdates": {
    string: {
      object(LineItemUpdate)
    },
    ...
  },
  "userNotification": {
    object (UserNotification)
  },
  "infoExtension": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field info can be only one of the following:
  "rejectionInfo": {
    object (RejectionInfo)
  },
  "cancellationInfo": {
    object (CancellationInfo)
  },
  "inTransitInfo": {
    object (InTransitInfo)
  },
  "fulfillmentInfo": {
    object (FulfillmentInfo)
  },
  "returnInfo": {
    object (ReturnInfo)
  }
  // End of list of possible types for union field info.
}
ช่อง
googleOrderId

string

รหัสของคำสั่งซื้อคือรหัสที่ออกโดย Google
actionOrderId

string

ต้องระบุ รหัสคำสั่งซื้อ Canonical ที่อ้างอิงคำสั่งซื้อนี้ หากผู้ผสานรวมระบบไม่สร้างรหัสคำสั่งซื้อ Canonical ในระบบ ก็สามารถคัดลอก googleOrderId ที่รวมตามลำดับได้
orderState

object (OrderState)

สถานะใหม่ของคำสั่งซื้อ
orderManagementActions[]

object (Action)

อัปเดตการดำเนินการจัดการคำสั่งซื้อที่เกี่ยวข้องแล้ว เช่น จัดการ แก้ไข หรือติดต่อฝ่ายสนับสนุน
receipt

object (Receipt)

ใบเสร็จของการสั่งซื้อ
updateTime

string (Timestamp format)

เมื่อมีการอัปเดตคำสั่งซื้อจากมุมมองของแอป

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: "2014-10-02T15:01:23.045123456Z"
totalPrice

object (Price)

ราคารวมใหม่ของคำสั่งซื้อ
lineItemUpdates

map (key: string, value: object (LineItemUpdate))

แผนที่การเปลี่ยนแปลงระดับรายการโฆษณา คีย์ตามรหัสรายการ ไม่บังคับ

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
userNotification

object (UserNotification)

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

object

ข้อมูลเพิ่มเติมตามสถานะคำสั่งซื้อที่กำหนดเองหรือเพิ่มเติมจากข้อมูลสถานะมาตรฐาน

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }
ช่องการรวม info ข้อมูลเพิ่มเติมที่เชื่อมโยงกับสถานะของคำสั่งซื้อ info ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
rejectionInfo

object (RejectionInfo)

ข้อมูลเกี่ยวกับสถานะการปฏิเสธ
cancellationInfo

object (CancellationInfo)

ข้อมูลเกี่ยวกับสถานะการยกเลิก
inTransitInfo

object (InTransitInfo)

ข้อมูลเกี่ยวกับสถานะการขนส่ง
fulfillmentInfo

object (FulfillmentInfo)

ข้อมูลเกี่ยวกับสถานะการดำเนินการตามคำสั่งซื้อ
returnInfo

object (ReturnInfo)

ข้อมูลเกี่ยวกับสถานะที่แสดงผล

การดำเนินการ

การดำเนินการติดตามผลที่เชื่อมโยงกับการอัปเดตคำสั่งซื้อ

การแสดง JSON 
{
  "type": enum (ActionType),
  "button": {
    object (Button)
  }
}
ช่อง
type

enum (ActionType)

ประเภทการดำเนินการ
button

object (Button)

ป้ายกำกับปุ่มและลิงก์

ใบเสร็จรับเงิน

เลิกใช้งานแล้ว: ใช้ Proto V3 แทน ได้รับเมื่อรัฐ CONFIRMED หรือสถานะอื่น ๆ (เช่น IN_TRANSIT, FULFILLED) รวมสถานะ CONFIRMED

การแสดง JSON 
{
  "confirmedActionOrderId": string,
  "userVisibleOrderId": string
}
ช่อง
confirmedActionOrderId
(deprecated)

string

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

โปรดทราบว่าช่องนี้เลิกใช้งานแล้ว โปรดส่งฟิลด์ผ่าน OrderUpdate.action_order_id แทน
userVisibleOrderId

string

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

RejectionInfo

ข้อมูลการปฏิเสธเมื่อสถานะถูกปฏิเสธ ระบบสามารถป้อนข้อมูลข้อความนี้ในการอัปเดตคำสั่งซื้อครั้งแรกในการสนทนาหรือผ่านการอัปเดตคำสั่งซื้อแบบไม่พร้อมกันที่ตามมา

การแสดง JSON 
{
  "type": enum (ReasonType),
  "reason": string
}
ช่อง
type

enum (ReasonType)

ประเภทการปฏิเสธ
reason

string

สาเหตุของข้อผิดพลาด

CancellationInfo

เลิกใช้งานแล้ว: ใช้ Proto V3 แทน ข้อมูลการยกเลิกเมื่อสถานะถูกยกเลิก

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

string

เหตุผลในการยกเลิก

InTransitInfo

เลิกใช้งานแล้ว: ใช้ Proto V3 แทน ข้อมูลการขนส่งสาธารณะเมื่อรัฐคือ IN_TRANSIT

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

string (Timestamp format)

เวลาที่อัปเดตล่าสุดสำหรับขนส่งสาธารณะ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: "2014-10-02T15:01:23.045123456Z"

FulfillmentInfo

เลิกใช้งานแล้ว: ใช้ Proto V3 แทน ข้อมูลการดำเนินการเมื่ออยู่ในสถานะ "FULFILLED"

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

string (Timestamp format)

เวลาที่จะมีการดำเนินการตามคำสั่งซื้อ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: "2014-10-02T15:01:23.045123456Z"

ReturnInfo

เลิกใช้งานแล้ว: ใช้ Proto V3 แทน ข้อมูลการคืนสินค้าเมื่อรัฐถูกปฏิเสธ

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

string

เหตุผลในการคืนสินค้า

UserNotification

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

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

string

ชื่อการแจ้งเตือนผู้ใช้
text

string

เนื้อหาของการแจ้งเตือน

MediaResponse

คำตอบที่ระบุชุดสื่อที่จะเล่นภายในการสนทนา

การแสดง JSON 
{
  "mediaType": enum (MediaType),
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}
ช่อง
mediaType

enum (MediaType)

ของสื่อภายในคำตอบนี้
mediaObjects[]

object (MediaObject)

รายการออบเจ็กต์สื่อ

MediaObject

แสดงออบเจ็กต์สื่อ 1 รายการซึ่งแสดงผลด้วย MediaResponse มีข้อมูลเกี่ยวกับสื่อ เช่น ชื่อ, คำอธิบาย, URL ฯลฯ

การแสดง JSON 
{
  "name": string,
  "description": string,
  "contentUrl": string,

  // Union field image can be only one of the following:
  "largeImage": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}
ช่อง
name

string

ชื่อของออบเจ็กต์สื่อนี้
description

string

คำอธิบายของออบเจ็กต์สื่อนี้
contentUrl

string

URL ที่ชี้ไปยังเนื้อหาสื่อ
ช่องการรวม image รูปภาพที่จะแสดงพร้อมการ์ดสื่อ image ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
largeImage

object (Image)

รูปภาพขนาดใหญ่ เช่น ปกอัลบั้ม ฯลฯ
icon

object (Image)

ไอคอนรูปภาพขนาดเล็กที่แสดงอยู่ด้านขวาจากชื่อ โดยปรับขนาดเป็น 36x36 dp

CarouselBrowse

นำเสนอชุดเอกสาร AMP เป็นภาพสไลด์ของรายการขนาดใหญ่ ระบบอาจเลือกรายการเพื่อเปิดเอกสาร AMP ที่เกี่ยวข้องในโปรแกรมเปิด AMP

การแสดง JSON 
{
  "items": [
    {
      object (Item)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}
ช่อง
items[]

object (Item)

ขั้นต่ำ: 2 สูงสุด: 10
imageDisplayOptions

enum (ImageDisplayOptions)

ประเภทการแสดงรูปภาพ ไม่บังคับ

รายการ

รายการในภาพสไลด์

การแสดง JSON 
{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
ช่อง
title

string

ชื่อของรายการภาพสไลด์ ต้องระบุ
description

string

คำอธิบายรายการในภาพสไลด์ ไม่บังคับ
footer

string

ข้อความส่วนท้ายสำหรับรายการภาพสไลด์ แสดงใต้คำอธิบาย ข้อความบรรทัดเดียวที่ตัดให้สั้นลงด้วยจุดไข่ปลา ไม่บังคับ
image

object (Image)

รูปภาพหลักของรายการภาพสไลด์ ไม่บังคับ
openUrlAction

object (OpenUrlAction)

URL ของเอกสารที่เชื่อมโยงกับรายการภาพสไลด์ เอกสารอาจมีเนื้อหา HTML หรือหากเป็น "urlTypeHint" ตั้งค่าเป็น AMP_CONTENT, เนื้อหา AMP ต้องระบุ

TableCard

การ์ดตารางสำหรับแสดงตารางข้อความ

การแสดง JSON 
{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columnProperties": [
    {
      object (ColumnProperties)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "buttons": [
    {
      object (Button)
    }
  ]
}
ช่อง
title

string

ชื่อโดยรวมของตาราง ไม่บังคับ แต่ต้องตั้งค่าหากมีการตั้งค่าคำบรรยาย
subtitle

string

ชื่อรองของตาราง ไม่บังคับ
image

object (Image)

รูปภาพที่เชื่อมโยงกับตาราง ไม่บังคับ
columnProperties[]

object (ColumnProperties)

ส่วนหัวและการจัดแนวคอลัมน์
rows[]

object (Row)

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

object (Button)

ปุ่ม ขณะนี้รองรับเพียง 1 ปุ่มเท่านั้น ไม่บังคับ

ColumnProperties

เก็บคุณสมบัติของคอลัมน์ไว้ (รวมถึงส่วนหัว)

การแสดง JSON 
{
  "header": string,
  "horizontalAlignment": enum (HorizontalAlignment)
}
ช่อง
header

string

ข้อความส่วนหัวของคอลัมน์
horizontalAlignment

enum (HorizontalAlignment)

การจัดแนวแนวนอนของเนื้อหาในคอลัมน์ หากไม่ระบุ เนื้อหาจะอยู่ในแนวเดียวกับขอบนำหน้า

แถว

อธิบายแถวในตาราง

การแสดง JSON 
{
  "cells": [
    {
      object (Cell)
    }
  ],
  "dividerAfter": boolean
}
ช่อง
cells[]

object (Cell)

เซลล์ในแถวนี้ ระบบรับประกันว่าจะแสดง 3 เซลล์แรก แต่เซลล์อื่นๆ อาจถูกตัดออกในบางพื้นผิว โปรดทดสอบด้วยเครื่องมือจำลองเพื่อดูว่าจะแสดงเซลล์ใดบนพื้นผิวที่กำหนด
dividerAfter

boolean

ระบุว่าควรมีตัวแบ่งหลังจากแต่ละแถวหรือไม่

เซลล์

อธิบายเซลล์ในแถว

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

string

เนื้อหาข้อความของเซลล์

HtmlResponse

การตอบกลับที่แสดง HTML โดยใช้ฟีเจอร์ Canvas แบบอินเทอร์แอกทีฟ ขนาดสูงสุดของ การตอบสนองคือ 50,000 ไบต์

การแสดง JSON 
{
  "updatedState": value,
  "suppressMic": boolean,
  "url": string
}
ช่อง
updatedState

value (Value format)

สื่อสารออบเจ็กต์ JSON ต่อไปนี้กับแอป
suppressMic

boolean

ระบุตัวเลือกเพื่อไม่เปิดไมค์หลังจากคำตอบอย่างละเอียดนี้
url

string

URL ของแอปพลิเคชัน

คำแนะนำ

ชิปคำแนะนำที่ผู้ใช้แตะเพื่อโพสต์ตอบการสนทนาได้อย่างรวดเร็ว

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

string

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

LinkOutSuggestion

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

การแสดง JSON 
{
  "destinationName": string,
  "url": string,
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
ช่อง
destinationName

string

ชื่อของแอปหรือเว็บไซต์ที่ชิปนี้ลิงก์อยู่ ระบบจะแสดงผลชิปโดยใช้ชื่อ "เปิด " อักขระสูงสุด 20 ตัว ต้องระบุ
url
(deprecated)

string

เลิกใช้งานแล้ว ใช้ OpenUrlAction แทน
openUrlAction

object (OpenUrlAction)

URL ของแอปหรือเว็บไซต์ที่จะเปิดเมื่อผู้ใช้แตะชิปคำแนะนำ ต้องตรวจสอบการเป็นเจ้าของแอป/URL นี้ในการดำเนินการบน Google Developers Console มิฉะนั้นคำแนะนำจะไม่แสดงให้ผู้ใช้เห็น การดำเนินการ URL แบบเปิดรองรับ URL แบบ http, https และ Intent สำหรับ URL ของ Intent โปรดดู https://developer.chrome.com/multidevice/android/intents

ExpectedIntent

ความตั้งใจที่คาดหวังซึ่งแอปกำลังขอให้ Assistant ทำให้

การแสดง JSON 
{
  "intent": string,
  "inputValueData": {
    "@type": string,
    field1: ...,
    ...
  },
  "parameterName": string
}
ช่อง
intent

string

ชื่อ Intent ในตัว เช่น actions.intent.TEXT หรือ Intent ที่กำหนดไว้ในแพ็กเกจการดำเนินการ หาก Intent ที่ระบุไม่ใช่ Intent ในตัว ระบบจะใช้ Intent นี้กับการให้น้ำหนักคำพูดเท่านั้น และข้อมูลที่ป้อนโดย Google Assistant จะเป็น Intent actions.intent.TEXT
inputValueData

object

ต้องการข้อมูลการกําหนดค่าเพิ่มเติมสําหรับ Intent ในตัว ค่าที่เป็นไปได้สำหรับ Intent ในตัว: actions.intent.OPTION -> google.actions.v2.OptionValueSpec, actions.intent.CONFIRMATION -> google.actions.v2.ConfirmationValueSpec, actions.intent.TRANSACTION_REQUIREMENTS_CHECK -> google.actions.v2.TransactionRequirementsCheckSpec, actions.intent.DELIVERY_ADDRESS -> google.actions.v2.DeliveryAddressValueSpec, actions.intent.TRANSACTION_DECISION -> google.actions.v2.TransactionDecisionValueSpec, actions.intent.PLACE -> google.actions.v2.PlaceValueSpec, actions.intent.Link -> google.actions.v2.LinkValueSpec

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }
parameterName

string

(ไม่บังคับ) พารามิเตอร์ของ Intent ที่ขอ ใช้ได้สำหรับ Intent ที่ขอเท่านั้น ใช้สำหรับการให้น้ำหนักการพูด

FinalResponse

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

การแสดง JSON 
{

  // Union field response can be only one of the following:
  "speechResponse": {
    object (SpeechResponse)
  },
  "richResponse": {
    object (RichResponse)
  }
  // End of list of possible types for union field response.
}
ช่อง
ช่องการรวม response ประเภทคำตอบที่เป็นไปได้ response ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
speechResponse
(deprecated)

object (SpeechResponse)

พูดคำตอบเมื่อผู้ใช้ไม่จำเป็นต้องป้อนอินพุต
richResponse

object (RichResponse)

การตอบกลับที่สมบูรณ์เมื่อผู้ใช้ไม่จำเป็นต้องป้อนข้อมูล

CustomPushMessage

ข้อความพุชที่กำหนดเองซึ่งมีข้อมูลที่มีโครงสร้างเพื่อพุช Fulfillment API ของการดำเนินการ

การแสดง JSON 
{
  "target": {
    object (Target)
  },

  // Union field content can be only one of the following:
  "orderUpdate": {
    object (OrderUpdate)
  },
  "userNotification": {
    object (UserNotification)
  }
  // End of list of possible types for union field content.
}
ช่อง
target

object (Target)

เป้าหมายที่ระบุสำหรับคำขอพุช
ช่องการรวม content เพย์โหลดประเภทต่างๆ content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
orderUpdate

object (OrderUpdate)

การอัปเดตคำสั่งซื้อซึ่งอัปเดตคำสั่งซื้อที่ดำเนินการผ่าน API ธุรกรรม
userNotification

object (UserNotification)

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

UserNotification

การแจ้งเตือนผู้ใช้ที่จะแสดงพร้อมคำขอ

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

string

ชื่อการแจ้งเตือน
text

string

เนื้อหาของการแจ้งเตือน

เป้าหมาย

เป้าหมายที่ระบุสำหรับคำขอพุช

การแสดง JSON 
{
  "userId": string,
  "intent": string,
  "argument": {
    object (Argument)
  },
  "locale": string
}
ช่อง
userId

string

ผู้ใช้ที่จะกำหนดเป้าหมาย
intent

string

ความตั้งใจในการกำหนดเป้าหมาย
argument

object (Argument)

อาร์กิวเมนต์ที่จะกำหนดเป้าหมายสำหรับ Intent สำหรับ V1 จะมีการสนับสนุนเพียงอาร์กิวเมนต์เดียว
locale

string

ภาษาที่จะกำหนดเป้าหมาย เป็นไปตามรหัสภาษา IETF BCP-47 สามารถใช้โดยแอปหลายภาษาเพื่อกำหนดเป้าหมายผู้ใช้ในแอปภาษาท้องถิ่นที่ระบุ หากไม่ได้ระบุไว้ ระบบจะใช้ en-US เป็นค่าเริ่มต้น