AppResponse

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 (ExpectedInput)
    }
  ],
  "finalResponse": {
    object (FinalResponse)
  },
  "customPushMessage": {
    object (CustomPushMessage)
  },
  "isInSandbox": boolean
}
ช่อง
conversationToken

string

โทเค็นทึบ ซึ่งจะหมุนเวียนไปยังการดำเนินการทุกๆ การสนทนา

userStorage

string

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

resetUserStorage

boolean

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

expectUserResponse

boolean

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

expectedInputs[]

object (ExpectedInput)

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

finalResponse

object (FinalResponse)

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

customPushMessage

object (CustomPushMessage)

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

isInSandbox

boolean

ระบุว่าควรจัดการการตอบกลับในโหมดแซนด์บ็อกซ์หรือไม่ คุณจำเป็นต้องใช้บิตนี้เพื่อพุช Structured Data ไปยัง 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)

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

richInitialPrompt

object (RichResponse)

เพย์โหลดข้อความแจ้ง

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 เช่น " พูดชื่อสัตว์หลังเสียง " พร้อมใช้งานกับ textToSpeech เท่านั้น

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. คุณใช้รายการการตอบสนองแบบริชมีเดียไม่ได้หากคุณใช้ Intent ของ actions.intent.OPTION คือ 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)

การ์ดเรียกดูภาพสไลด์ ใช้ collectionsBrowse แทน

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

การตอบสนองที่กำหนดไว้เพื่อให้แอปตอบกลับด้วย Structured Data

การแสดง 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

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

การแสดง 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)

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

ใบเสร็จ

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

การแสดง 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

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

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

string

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

InTransitInfo

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

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

string (Timestamp format)

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

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

FulfillmentInfo

เลิกใช้งานแล้ว: ใช้ V3 Proto แทน ข้อมูลการดำเนินการตามคำสั่งซื้อเมื่อสถานะเสร็จสมบูรณ์แล้ว

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

string (Timestamp format)

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

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

ReturnInfo

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

การแสดง 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 กิโลไบต์

การแสดง 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 แบบเปิดรองรับ 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

string

ชื่อ Intent ในตัว เช่น actions.intent.TEXT หรือ 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