- Biểu diễn dưới dạng JSON
- ExpectedInput (Dự kiến)
- InputPrompt
- SpeechResponse
- RichResponse
- Mặt hàng
- SimpleResponse
- BasicCard
- Nút
- StructuredResponse
- OrderUpdate
- Thao tác
- Biên nhận
- RejectionInfo
- CancellationInfo
- InTransitInfo
- FulfillmentInfo
- ReturnInfo
- UserNotification
- MediaResponse
- MediaObject
- CarouselBrowse
- Mặt hàng
- TableCard
- ColumnProperties
- Hàng
- Ô
- HtmlResponse
- Đề xuất
- LinkOutSuggestion
- ExpectedIntent (Ý định dự kiến)
- FinalResponse
- CustomPushMessage
- UserNotification
- Mục tiêu
AppResponse là phản hồi do phương thức thực hiện gửi tới Trợ lý Google. Để xem ví dụ về cách dùng tính năng này trong Actions on Google, vui lòng truy cập https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json#conversation-response-body
Biểu diễn dưới dạng JSON | |
---|---|
{ "conversationToken": string, "userStorage": string, "resetUserStorage": boolean, "expectUserResponse": boolean, "expectedInputs": [ { object ( |
Các trường | |
---|---|
conversationToken |
Một mã thông báo mờ được tuần hoàn vào Hành động mỗi khi cuộc trò chuyện diễn ra. |
userStorage |
Một mã thông báo mờ do Hành động kiểm soát. Mã này được duy trì trong các cuộc trò chuyện của một người dùng cụ thể. Nếu để trống hoặc không được chỉ định, mã thông báo ổn định hiện có sẽ không thay đổi. Kích thước tối đa của chuỗi là 10k byte. Nếu nhiều hộp thoại xuất hiện đồng thời cho cùng một người dùng, thì nội dung cập nhật cho mã thông báo này có thể ghi đè lên nhau một cách bất ngờ. |
resetUserStorage |
Liệu có xoá userStorage vẫn tồn tại hay không. Nếu bạn đặt chính sách này thành true (đúng), thì trong lần tương tác tiếp theo với người dùng, trường userStorage sẽ trống. |
expectUserResponse |
Cho biết liệu Hành động này có mong đợi phản hồi của người dùng hay không. Điều này đúng khi cuộc trò chuyện đang diễn ra, sai khi cuộc trò chuyện kết thúc. |
expectedInputs[] |
Danh sách dữ liệu đầu vào mà Hành động dự kiến, mỗi dữ liệu đầu vào có thể là một hành động phổ biến đối với ý định của Google (bắt đầu bằng "actions.") hoặc dữ liệu đầu vào chứa danh sách các ý định có thể có. Hiện chỉ hỗ trợ một giá trị nhập. |
finalResponse |
Phản hồi cuối cùng khi Hành động không mong đợi hoạt động đầu vào của người dùng. |
customPushMessage |
Thông báo đẩy tuỳ chỉnh cho phép nhà phát triển gửi dữ liệu có cấu trúc đến các hành động trên Google. |
isInSandbox |
Cho biết có nên xử lý phản hồi ở chế độ hộp cát hay không. bit này cần thiết để đẩy dữ liệu có cấu trúc đến Google ở chế độ hộp cát. |
ExpectedInput
Biểu diễn dưới dạng JSON | |
---|---|
{ "inputPrompt": { object ( |
Các trường | |
---|---|
inputPrompt |
Lời nhắc tuỳ chỉnh dùng để yêu cầu người dùng nhập thông tin. |
possibleIntents[] |
Danh sách các ý định có thể dùng để thực hiện thông tin đầu vào này. Để các hành động trên Google chỉ cần trả về hoạt động đầu vào chưa qua xử lý của người dùng, ứng dụng phải yêu cầu ý định |
speechBiasingHints[] |
Danh sách các cụm từ mà Hành động đó muốn Google sử dụng để xu hướng lời nói. Bạn được phép sử dụng tối đa 1.000 cụm từ. |
InputPrompt
Lời nhắc nhập được dùng để trợ lý hướng dẫn người dùng nhập câu hỏi cho ứng dụng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "initialPrompts": [ { object ( |
Các trường | |
---|---|
initialPrompts[] |
Các lời nhắc ban đầu yêu cầu người dùng cung cấp thông tin đầu vào. Chỉ hỗ trợ một chữ initial_prompt. |
richInitialPrompt |
Tải trọng lời nhắc. |
noInputPrompts[] |
Lời nhắc dùng để hỏi người dùng khi không có thông tin đầu vào từ người dùng. |
SpeechResponse
Câu trả lời chỉ chứa lời nói. KHÔNG DÙNG NỮA.
Biểu diễn dưới dạng JSON | |
---|---|
{ // Union field |
Các trường | ||
---|---|---|
Trường nhóm type . Loại đầu ra bằng giọng nói: văn bản sang lời nói hoặc SSML. type chỉ có thể là một trong những trạng thái sau đây: |
||
textToSpeech |
Văn bản thuần tuý của đầu ra bằng lời nói, ví dụ: "bạn muốn đi đâu?"/ |
|
ssml |
Phản hồi bằng giọng nói có cấu trúc với người dùng ở định dạng SSML, ví dụ: " |
RichResponse
Câu trả lời phong phú có thể bao gồm âm thanh, văn bản, thẻ, nội dung đề xuất và dữ liệu có cấu trúc.
Biểu diễn dưới dạng JSON | |
---|---|
{ "items": [ { object ( |
Các trường | |
---|---|
items[] |
Danh sách các thành phần trên giao diện người dùng để soạn phản hồi Các mục phải đáp ứng những yêu cầu sau: 1. Mục đầu tiên phải là |
suggestions[] |
Danh sách các câu trả lời đề xuất. Các thông tin này sẽ luôn xuất hiện ở cuối câu trả lời. Nếu được dùng trong |
linkOutSuggestion |
Khối đề xuất bổ sung có thể liên kết đến ứng dụng hoặc trang web được liên kết. |
Mục
Các mục trong câu trả lời.
Biểu diễn dưới dạng JSON | |
---|---|
{ "name": string, // Union field |
Các trường | ||
---|---|---|
name |
Giá trị nhận dạng có tên không bắt buộc của mặt hàng này. |
|
Trường nhóm item . Loại mục. item chỉ có thể là một trong những trạng thái sau đây: |
||
simpleResponse |
Trả lời bằng giọng nói và văn bản. |
|
basicCard |
Một thẻ cơ bản. |
|
structuredResponse |
Tải trọng có cấu trúc cần Google xử lý. |
|
mediaResponse |
Phản hồi cho biết một nhóm nội dung nghe nhìn sẽ phát. |
|
carouselBrowse |
Thẻ duyệt dạng băng chuyền, thay vào đó hãy sử dụng collectionBrowse. |
|
tableCard |
Thẻ bảng. |
|
htmlResponse |
Phản hồi HTML được dùng để hiển thị trên Canvas. |
SimpleResponse
Một phản hồi đơn giản có chứa lời nói hoặc văn bản sẽ hiển thị cho người dùng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "textToSpeech": string, "ssml": string, "displayText": string } |
Các trường | |
---|---|
textToSpeech |
Văn bản thuần tuý của đầu ra bằng lời nói, ví dụ: "bạn muốn đi đâu?" Loại trừ lẫn nhau với ssml. |
ssml |
Phản hồi bằng giọng nói có cấu trúc cho người dùng ở định dạng SSML, ví dụ: |
displayText |
Văn bản không bắt buộc xuất hiện trong bong bóng trò chuyện. Nếu bạn không cung cấp, chế độ hiển thị kết xuất văn bản textTospeech hoặc ssml ở trên sẽ được sử dụng. Giới hạn ở 640 ký tự. |
BasicCard
Một thẻ cơ bản để hiển thị một số thông tin (ví dụ: hình ảnh và/hoặc văn bản).
Biểu diễn dưới dạng JSON | |
---|---|
{ "title": string, "subtitle": string, "formattedText": string, "image": { object ( |
Các trường | |
---|---|
title |
Tiêu đề chung của thẻ. Không bắt buộc. |
subtitle |
Không bắt buộc. |
formattedText |
Văn bản nội dung của thẻ. Hỗ trợ một số cú pháp Markdown có giới hạn để định dạng. Bắt buộc, trừ khi có hình ảnh. |
image |
Hình ảnh chính cho thẻ. Chiều cao được cố định là 192 dp. Không bắt buộc. |
buttons[] |
Nút. Hiện tại, hệ thống hỗ trợ tối đa 1 nút. Không bắt buộc. |
imageDisplayOptions |
loại hiển thị hình ảnh. Không bắt buộc. |
Nút
Một đối tượng nút thường xuất hiện ở cuối thẻ.
Biểu diễn dưới dạng JSON | |
---|---|
{
"title": string,
"openUrlAction": {
object ( |
Các trường | |
---|---|
title |
tiêu đề của nút. Bắt buộc. |
openUrlAction |
Hành động cần thực hiện khi người dùng nhấn vào nút. Bắt buộc. |
StructuredResponse
Nội dung phản hồi được xác định để ứng dụng phản hồi bằng dữ liệu có cấu trúc.
Biểu diễn dưới dạng JSON | |
---|---|
{ // Union field |
Các trường | ||
---|---|---|
Trường nhóm data . Vùng chứa phản hồi tải trọng từ nhân viên hỗ trợ bên thứ ba. data chỉ có thể là một trong những trạng thái sau đây: |
||
orderUpdate |
Ứng dụng cung cấp thông tin cập nhật về đơn đặt hàng (ví dụ: |
|
orderUpdateV3 |
Sau khi nhận được đơn đặt hàng, ứng dụng sẽ cập nhật đơn đặt hàng ở định dạng API phiên bản 3. |
OrderUpdate
Ngừng sử dụng: Thay vào đó, hãy dùng Proto V3. Cập nhật thành đơn đặt hàng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "googleOrderId": string, "actionOrderId": string, "orderState": { object ( |
Các trường | ||
---|---|---|
googleOrderId |
Mã đơn đặt hàng là mã do Google cấp. |
|
actionOrderId |
Bắt buộc. Mã đơn hàng chuẩn tham chiếu đến đơn đặt hàng này. Nếu các nhà tích hợp không tạo mã đơn hàng chuẩn trong hệ thống của mình, họ chỉ cần sao chép qua googleOrderId có trong thứ tự. |
|
orderState |
Trạng thái mới của đơn đặt hàng. |
|
orderManagementActions[] |
Cập nhật các hành động quản lý có thể áp dụng cho đơn đặt hàng, ví dụ: quản lý, sửa đổi, liên hệ với bộ phận hỗ trợ. |
|
receipt |
Biên nhận cho đơn đặt hàng. |
|
updateTime |
Khi đơn đặt hàng được cập nhật từ góc độ của ứng dụng. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, chính xác đến nano giây. Ví dụ: |
|
totalPrice |
Tổng giá mới của đơn đặt hàng |
|
lineItemUpdates |
Bản đồ các thay đổi ở cấp mục hàng, được khoá theo mã mục. Không bắt buộc. Một đối tượng chứa danh sách các cặp |
|
userNotification |
Nếu được chỉ định, hiển thị thông báo cho người dùng cùng với tiêu đề và văn bản đã chỉ định. Chỉ định thông báo là một gợi ý để thông báo và không đảm bảo sẽ tạo ra thông báo. |
|
infoExtension |
Dữ liệu bổ sung dựa trên trạng thái đơn đặt hàng tuỳ chỉnh hoặc ngoài thông tin về trạng thái tiêu chuẩn. Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung |
|
Trường nhóm info . Thông tin bổ sung liên quan đến trạng thái của đơn đặt hàng. info chỉ có thể là một trong những trạng thái sau đây: |
||
rejectionInfo |
Thông tin về trạng thái từ chối. |
|
cancellationInfo |
Thông tin về trạng thái huỷ. |
|
inTransitInfo |
Thông tin về trạng thái phương tiện công cộng. |
|
fulfillmentInfo |
Thông tin về trạng thái thực hiện nhiệm vụ. |
|
returnInfo |
Thông tin về trạng thái trả về. |
Hành động
Hành động tiếp theo liên quan đến thông tin cập nhật về đơn đặt hàng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "type": enum ( |
Các trường | |
---|---|
type |
loại hành động. |
button |
Nhãn và đường liên kết của nút. |
Biên nhận
Ngừng sử dụng: Thay vào đó, hãy dùng Proto V3. Biên nhận khi trạng thái là ĐÃ XÁC NHẬN hoặc bất kỳ trạng thái nào khác (ví dụ: IN_TRANSIT, FULFILLED) bao gồm trạng thái ĐÃ XÁC NHẬN.
Biểu diễn dưới dạng JSON | |
---|---|
{ "confirmedActionOrderId": string, "userVisibleOrderId": string } |
Các trường | |
---|---|
confirmedActionOrderId |
Mã đơn hàng được xác nhận khi nhà tích hợp nhận được đơn đặt hàng. Đây là mã thứ tự chuẩn hoá dùng trong hệ thống của nhà tích hợp khi tham chiếu đến đơn đặt hàng và sau đó có thể được dùng để xác định đơn đặt hàng là Xin lưu ý rằng trường này không được dùng nữa. Thay vào đó, vui lòng chuyển trường này thông qua OrderUpdate.action_order_id. |
userVisibleOrderId |
Không bắt buộc. Mã nhận dạng dành cho người dùng đang tham chiếu đến đơn đặt hàng hiện tại. Đơn đặt hàng này sẽ xuất hiện trong thẻ biên nhận nếu có. Đây phải là mã nhận dạng thường xuất hiện trên biên nhận dạng bản in hoặc biên nhận được gửi tới email của người dùng. Người dùng phải sử dụng được mã nhận dạng này khi tham chiếu đến đơn đặt hàng của mình cho dịch vụ khách hàng do các công ty tích hợp cung cấp. Xin lưu ý rằng bạn phải điền trường này nếu nhà tích hợp tạo mã nhận dạng dành cho người dùng cho đơn đặt hàng có biên nhận đã in / biên nhận qua email. |
RejectionInfo
Thông tin từ chối khi trạng thái BỊ TỪ CHỐI. Thông báo này có thể được điền trong lần cập nhật đơn đặt hàng ban đầu trong cuộc trò chuyện hoặc thông qua lần cập nhật đơn đặt hàng không đồng bộ tiếp theo.
Biểu diễn dưới dạng JSON | |
---|---|
{
"type": enum ( |
Các trường | |
---|---|
type |
Loại lý do từ chối. |
reason |
Lý do lỗi. |
CancellationInfo
Ngừng sử dụng: Thay vào đó, hãy dùng Proto V3. Thông tin huỷ khi trạng thái là CANCELLED.
Biểu diễn dưới dạng JSON | |
---|---|
{ "reason": string } |
Các trường | |
---|---|
reason |
Lý do huỷ. |
InTransitInfo
Ngừng sử dụng: Thay vào đó, hãy dùng Proto V3. Thông tin trên phương tiện công cộng khi trạng thái là IN_TRANSIT.
Biểu diễn dưới dạng JSON | |
---|---|
{ "updatedTime": string } |
Các trường | |
---|---|
updatedTime |
Thời gian cập nhật gần đây nhất cho phương tiện công cộng. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, chính xác đến nano giây. Ví dụ: |
FulfillmentInfo
Ngừng sử dụng: Thay vào đó, hãy dùng Proto V3. Thông tin về phương thức thực hiện khi trạng thái là FULFILLED.
Biểu diễn dưới dạng JSON | |
---|---|
{ "deliveryTime": string } |
Các trường | |
---|---|
deliveryTime |
Thời điểm đơn đặt hàng sẽ được thực hiện. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, chính xác đến nano giây. Ví dụ: |
ReturnInfo
Ngừng sử dụng: Thay vào đó, hãy dùng Proto V3. Thông tin trả lại hàng khi trạng thái BỊ TỪ CHỐI.
Biểu diễn dưới dạng JSON | |
---|---|
{ "reason": string } |
Các trường | |
---|---|
reason |
Lý do trả lại hàng. |
UserNotification
Thông báo không bắt buộc cho người dùng trong nội dung cập nhật về Đơn đặt hàng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "title": string, "text": string } |
Các trường | |
---|---|
title |
Tiêu đề của thông báo cho người dùng. |
text |
Nội dung của thông báo. |
MediaResponse
Phản hồi cho biết một nhóm nội dung nghe nhìn sẽ được phát trong cuộc trò chuyện.
Biểu diễn dưới dạng JSON | |
---|---|
{ "mediaType": enum ( |
Các trường | |
---|---|
mediaType |
loại nội dung đa phương tiện trong câu trả lời này. |
mediaObjects[] |
Danh sách đối tượng đa phương tiện. |
MediaObject
Đại diện cho một đối tượng đa phương tiện được trả về bằng MediaResponse. Chứa thông tin về nội dung nghe nhìn, chẳng hạn như tên, nội dung mô tả, URL, v.v.
Biểu diễn dưới dạng JSON | |
---|---|
{ "name": string, "description": string, "contentUrl": string, // Union field |
Các trường | ||
---|---|---|
name |
tên của đối tượng nội dung đa phương tiện này. |
|
description |
mô tả về đối tượng nội dung đa phương tiện này. |
|
contentUrl |
URL trỏ đến nội dung nghe nhìn. |
|
Trường nhóm image . Hình ảnh để hiển thị cùng với thẻ nội dung đa phương tiện. image chỉ có thể là một trong những trạng thái sau đây: |
||
largeImage |
Một hình ảnh lớn, chẳng hạn như bìa album, v.v. |
|
icon |
Một biểu tượng hình ảnh nhỏ ở bên phải của tiêu đề. Nó được đổi kích thước thành 36x36 dp. |
CarouselBrowse
Trình bày một nhóm tài liệu AMP dưới dạng băng chuyền gồm các mục ô lớn. Bạn có thể chọn các mục để chạy tài liệu AMP được liên kết trong trình xem AMP.
Biểu diễn dưới dạng JSON | |
---|---|
{ "items": [ { object ( |
Các trường | |
---|---|
items[] |
Tối thiểu: 2. Tối đa: 10. |
imageDisplayOptions |
loại hiển thị hình ảnh. Không bắt buộc. |
Mục
Mục trong băng chuyền.
Biểu diễn dưới dạng JSON | |
---|---|
{ "title": string, "description": string, "footer": string, "image": { object ( |
Các trường | |
---|---|
title |
tiêu đề của mục băng chuyền. Bắt buộc. |
description |
nội dung mô tả về mục băng chuyền. Không bắt buộc. |
footer |
Văn bản chân trang cho mục băng chuyền, hiển thị bên dưới phần mô tả. Một dòng văn bản, bị cắt ngắn bằng dấu ba chấm. Không bắt buộc. |
image |
Hình ảnh chính cho mục băng chuyền. Không bắt buộc. |
openUrlAction |
URL của tài liệu liên kết với mục băng chuyền. Tài liệu có thể chứa nội dung HTML hoặc nội dung AMP nếu "urlTypeHint" được đặt thành AMP_CONTENT. Bắt buộc. |
TableCard
Thẻ bảng để trình bày một bảng văn bản.
Biểu diễn dưới dạng JSON | |
---|---|
{ "title": string, "subtitle": string, "image": { object ( |
Các trường | |
---|---|
title |
Tiêu đề chung của bảng. Không bắt buộc nhưng phải đặt nếu đã đặt tiêu đề phụ. |
subtitle |
Tiêu đề phụ cho bảng. Không bắt buộc. |
image |
Hình ảnh được liên kết với bảng. Không bắt buộc. |
columnProperties[] |
Tiêu đề và căn chỉnh các cột. |
rows[] |
Dữ liệu hàng của bảng. 3 hàng đầu tiên chắc chắn sẽ xuất hiện, nhưng những hàng khác có thể bị cắt trên một số vị trí. Vui lòng thử nghiệm bằng trình mô phỏng để xem hàng nào sẽ xuất hiện trên một nền tảng nhất định. Trên các nền tảng hỗ trợ chức năng WEB_BROWSER, bạn có thể trỏ người dùng đến một trang web có nhiều dữ liệu hơn. |
buttons[] |
Nút. Hiện tại, hệ thống hỗ trợ tối đa 1 nút. Không bắt buộc. |
ColumnProperties
Giữ lại thuộc tính của các cột (bao gồm cả tiêu đề).
Biểu diễn dưới dạng JSON | |
---|---|
{
"header": string,
"horizontalAlignment": enum ( |
Các trường | |
---|---|
header |
Văn bản tiêu đề cho cột. |
horizontalAlignment |
Căn ngang nội dung với cột t.r.t. Nếu chưa chỉ định, nội dung sẽ được căn chỉnh vào cạnh trên cùng. |
Hàng
Mô tả một hàng trong bảng.
Biểu diễn dưới dạng JSON | |
---|---|
{
"cells": [
{
object ( |
Các trường | |
---|---|
cells[] |
Các ô trong hàng này. 3 ô đầu tiên được đảm bảo sẽ hiển thị, nhưng các ô khác có thể bị cắt trên một số bề mặt nhất định. Vui lòng thử nghiệm bằng trình mô phỏng để xem ô nào sẽ xuất hiện trên một nền tảng nhất định. |
dividerAfter |
Cho biết có cần dùng dải phân cách sau mỗi hàng hay không. |
Ô
Mô tả một ô trong hàng.
Biểu diễn dưới dạng JSON | |
---|---|
{ "text": string } |
Các trường | |
---|---|
text |
Nội dung văn bản của ô. |
HtmlResponse
Phản hồi hiển thị HTML bằng tính năng canvas tương tác. Kích thước tối đa của phản hồi là 50 nghìn byte.
Biểu diễn dưới dạng JSON | |
---|---|
{ "updatedState": value, "suppressMic": boolean, "url": string } |
Các trường | |
---|---|
updatedState |
Giao tiếp đối tượng JSON sau đây đến ứng dụng. |
suppressMic |
Cung cấp một tuỳ chọn sao cho micrô sẽ không được mở sau câu trả lời trực quan này. |
url |
URL của ứng dụng. |
Đề xuất
Một khối đề xuất mà người dùng có thể nhấn vào để đăng nhanh câu trả lời cho cuộc trò chuyện.
Biểu diễn dưới dạng JSON | |
---|---|
{ "title": string } |
Các trường | |
---|---|
title |
Văn bản xuất hiện trong khối đề xuất. Khi được nhấn, văn bản này sẽ được đăng lại nguyên văn trong cuộc trò chuyện như thể người dùng đã nhập. Mỗi tiêu đề phải là duy nhất trong tập hợp khối đề xuất. Bắt buộc phải có tối đa 25 ký tự |
LinkOutSuggestion
Tạo một khối đề xuất cho phép người dùng chuyển đến Ứng dụng hoặc trang web liên kết với nhân viên hỗ trợ này.
Biểu diễn dưới dạng JSON | |
---|---|
{
"destinationName": string,
"url": string,
"openUrlAction": {
object ( |
Các trường | |
---|---|
destinationName |
Tên của ứng dụng hoặc trang web mà khối này đang liên kết đến. Khối sẽ được kết xuất với tiêu đề "Open |
url |
Không dùng nữa. Thay vào đó, hãy sử dụng OpenUrlAction. |
openUrlAction |
URL của ứng dụng hoặc trang web sẽ mở khi người dùng nhấn vào khối đề xuất. Quyền sở hữu Ứng dụng/URL này phải được xác thực trong các thao tác trên Google Developer Console, nếu không, người dùng sẽ không thấy nội dung đề xuất. Hành động mở URL hỗ trợ http, https và URL ý định. Đối với URL ý định, hãy tham khảo: https://developer.chrome.com/multidevice/android/intents |
ExpectedIntent
Ý định dự kiến mà ứng dụng yêu cầu trợ lý cung cấp.
Biểu diễn dưới dạng JSON | |
---|---|
{ "intent": string, "inputValueData": { "@type": string, field1: ..., ... }, "parameterName": string } |
Các trường | |
---|---|
intent |
Tên ý định tích hợp (ví dụ: |
inputValueData |
Ý định tích hợp bắt buộc phải có thêm dữ liệu cấu hình. Các giá trị có thể sử dụng cho ý định tích hợp: Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung |
parameterName |
Một tham số của ý định đang được yêu cầu (không bắt buộc). Chỉ hợp lệ cho các ý định được yêu cầu. Dùng cho xu hướng lời nói. |
FinalResponse
Phản hồi cuối cùng khi hoạt động đầu vào của người dùng không theo dự kiến.
Biểu diễn dưới dạng JSON | |
---|---|
{ // Union field |
Các trường | ||
---|---|---|
Trường nhóm response . Các loại câu trả lời có thể có. response chỉ có thể là một trong những trạng thái sau đây: |
||
speechResponse |
Phản hồi bằng giọng nói khi người dùng không cần cung cấp thông tin đầu vào. |
|
richResponse |
Phản hồi chi tiết khi người dùng không yêu cầu cung cấp thông tin đầu vào. |
CustomPushMessage
Một thông báo đẩy tuỳ chỉnh chứa dữ liệu có cấu trúc để thúc đẩy hành động Fulfillment API.
Biểu diễn dưới dạng JSON | |
---|---|
{ "target": { object ( |
Các trường | ||
---|---|---|
target |
Mục tiêu được chỉ định cho yêu cầu đẩy. |
|
Trường nhóm content . Các loại tải trọng khác nhau. content chỉ có thể là một trong những trạng thái sau đây: |
||
orderUpdate |
Thông tin cập nhật về đơn đặt hàng cập nhật các đơn đặt hàng được đặt thông qua API giao dịch. |
|
userNotification |
Nếu được chỉ định, hiển thị thông báo cho người dùng với tiêu đề và văn bản được chỉ định. |
UserNotification
Thông báo cho người dùng để hiển thị cùng với yêu cầu.
Biểu diễn dưới dạng JSON | |
---|---|
{ "title": string, "text": string } |
Các trường | |
---|---|
title |
Tiêu đề của thông báo. |
text |
Nội dung thông báo. |
Mục tiêu
Mục tiêu được chỉ định cho yêu cầu đẩy.
Biểu diễn dưới dạng JSON | |
---|---|
{
"userId": string,
"intent": string,
"argument": {
object ( |
Các trường | |
---|---|
userId |
Người dùng cần nhắm mục tiêu. |
intent |
Ý định để nhắm mục tiêu. |
argument |
Đối số để nhắm mục tiêu cho một ý định. Đối với phiên bản 1, chỉ có một Đối số được hỗ trợ. |
locale |
Ngôn ngữ cần nhắm mục tiêu. Tuân theo mã ngôn ngữ IETF BCP-47. Có thể được ứng dụng đa ngôn ngữ sử dụng để nhắm đến người dùng trên một ứng dụng cụ thể đã bản địa hoá. Nếu không được chỉ định thì chế độ mặc định sẽ là tiếng Anh – Mỹ. |