AppResponse

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 (ExpectedInput)
    }
  ],
  "finalResponse": {
    object (FinalResponse)
  },
  "customPushMessage": {
    object (CustomPushMessage)
  },
  "isInSandbox": boolean
}
Các trường
conversationToken

string

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

string

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

boolean

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

boolean

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[]

object (ExpectedInput)

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

object (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

object (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

boolean

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 (InputPrompt)
  },
  "possibleIntents": [
    {
      object (ExpectedIntent)
    }
  ],
  "speechBiasingHints": [
    string
  ]
}
Các trường
inputPrompt

object (InputPrompt)

Lời nhắc tuỳ chỉnh dùng để yêu cầu người dùng nhập thông tin.

possibleIntents[]

object (ExpectedIntent)

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 actions.intent.TEXT.

speechBiasingHints[]

string

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 (SpeechResponse)
    }
  ],
  "richInitialPrompt": {
    object (RichResponse)
  },
  "noInputPrompts": [
    {
      object (SimpleResponse)
    }
  ]
}
Các trường
initialPrompts[]
(deprecated)

object (SpeechResponse)

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

object (RichResponse)

Tải trọng lời nhắc.

noInputPrompts[]

object (SimpleResponse)

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 type can be only one of the following:
  "textToSpeech": string,
  "ssml": string
  // End of list of possible types for union field type.
}
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

string

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

string

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ụ: " Nói tên động vật sau âm thanh. ". Loại trừ lẫn nhau bằng textTospeech.

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 (Item)
    }
  ],
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "linkOutSuggestion": {
    object (LinkOutSuggestion)
  }
}
Các trường
items[]

object (Item)

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à SimpleResponse 2. Tối đa hai SimpleResponse 3. Tối đa một mục trong câu trả lời đa dạng thức (ví dụ: BasicCard, StructuredResponse, MediaResponse hoặc HtmlResponse) 4. Bạn không thể sử dụng mục phản hồi nhiều định dạng nếu đang sử dụng ý định actions.intent.OPTION, tức là ListSelect hoặc CarouselSelect

suggestions[]

object (Suggestion)

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 FinalResponse, các giá trị này sẽ bị bỏ qua.

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 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.
}
Các trường
name

string

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

object (SimpleResponse)

Trả lời bằng giọng nói và văn bản.

basicCard

object (BasicCard)

Một thẻ cơ bản.

structuredResponse

object (StructuredResponse)

Tải trọng có cấu trúc cần Google xử lý.

mediaResponse

object (MediaResponse)

Phản hồi cho biết một nhóm nội dung nghe nhìn sẽ phát.

carouselBrowse

object (CarouselBrowse)

Thẻ duyệt dạng băng chuyền, thay vào đó hãy sử dụng collectionBrowse.

tableCard

object (TableCard)

Thẻ bảng.

htmlResponse

object (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

string

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

string

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ụ: <speak> Say animal name after the sound. <audio src = 'https://www.pullstring.com/moo.mps' />, what’s the animal? </speak>. Loại trừ lẫn nhau bằng textTospeech.

displayText

string

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 (Image)
  },
  "buttons": [
    {
      object (Button)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}
Các trường
title

string

Tiêu đề chung của thẻ. Không bắt buộc.

subtitle

string

Không bắt buộc.

formattedText

string

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

object (Image)

Hình ảnh chính cho thẻ. Chiều cao được cố định là 192 dp. Không bắt buộc.

buttons[]

object (Button)

Nút. Hiện tại, hệ thống hỗ trợ tối đa 1 nút. Không bắt buộc.

imageDisplayOptions

enum (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 (OpenUrlAction)
  }
}
Các trường
title

string

tiêu đề của nút. Bắt buộc.

openUrlAction

object (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 data can be only one of the following:
  "orderUpdate": {
    object (OrderUpdate)
  },
  "orderUpdateV3": {
    object (OrderUpdate)
  }
  // End of list of possible types for union field data.
}
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

object (OrderUpdate)

Ứng dụng cung cấp thông tin cập nhật về đơn đặt hàng (ví dụ: Receipt) sau khi nhận được đơn đặt hàng.

orderUpdateV3

object (OrderUpdate)

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 (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.
}
Các trường
googleOrderId

string

Mã đơn đặt hàng là mã do Google cấp.

actionOrderId

string

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

object (OrderState)

Trạng thái mới của đơn đặt hàng.

orderManagementActions[]

object (Action)

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

object (Receipt)

Biên nhận cho đơn đặt hàng.

updateTime

string (Timestamp format)

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ụ: "2014-10-02T15:01:23.045123456Z"

totalPrice

object (Price)

Tổng giá mới của đơn đặt hàng

lineItemUpdates

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

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 "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

userNotification

object (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

object

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 "@type" chứa URI nhận dạng loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.

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

object (RejectionInfo)

Thông tin về trạng thái từ chối.

cancellationInfo

object (CancellationInfo)

Thông tin về trạng thái huỷ.

inTransitInfo

object (InTransitInfo)

Thông tin về trạng thái phương tiện công cộng.

fulfillmentInfo

object (FulfillmentInfo)

Thông tin về trạng thái thực hiện nhiệm vụ.

returnInfo

object (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 (ActionType),
  "button": {
    object (Button)
  }
}
Các trường
type

enum (ActionType)

loại hành động.

button

object (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
(deprecated)

string

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à actionOrderId.

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

string

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 (ReasonType),
  "reason": string
}
Các trường
type

enum (ReasonType)

Loại lý do từ chối.

reason

string

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

string

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

string (Timestamp format)

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ụ: "2014-10-02T15:01:23.045123456Z"

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

string (Timestamp format)

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ụ: "2014-10-02T15:01:23.045123456Z"

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

string

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

string

Tiêu đề của thông báo cho người dùng.

text

string

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 (MediaType),
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ]
}
Các trường
mediaType

enum (MediaType)

loại nội dung đa phương tiện trong câu trả lời này.

mediaObjects[]

object (MediaObject)

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 image can be only one of the following:
  "largeImage": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}
Các trường
name

string

tên của đối tượng nội dung đa phương tiện này.

description

string

mô tả về đối tượng nội dung đa phương tiện này.

contentUrl

string

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

object (Image)

Một hình ảnh lớn, chẳng hạn như bìa album, v.v.

icon

object (Image)

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 (Item)
    }
  ],
  "imageDisplayOptions": enum (ImageDisplayOptions)
}
Các trường
items[]

object (Item)

Tối thiểu: 2. Tối đa: 10.

imageDisplayOptions

enum (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 (Image)
  },
  "openUrlAction": {
    object (OpenUrlAction)
  }
}
Các trường
title

string

tiêu đề của mục băng chuyền. Bắt buộc.

description

string

nội dung mô tả về mục băng chuyền. Không bắt buộc.

footer

string

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

object (Image)

Hình ảnh chính cho mục băng chuyền. Không bắt buộc.

openUrlAction

object (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 (Image)
  },
  "columnProperties": [
    {
      object (ColumnProperties)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "buttons": [
    {
      object (Button)
    }
  ]
}
Các trường
title

string

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

string

Tiêu đề phụ cho bảng. Không bắt buộc.

image

object (Image)

Hình ảnh được liên kết với bảng. Không bắt buộc.

columnProperties[]

object (ColumnProperties)

Tiêu đề và căn chỉnh các cột.

rows[]

object (Row)

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[]

object (Button)

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 (HorizontalAlignment)
}
Các trường
header

string

Văn bản tiêu đề cho cột.

horizontalAlignment

enum (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 (Cell)
    }
  ],
  "dividerAfter": boolean
}
Các trường
cells[]

object (Cell)

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

boolean

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

string

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

value (Value format)

Giao tiếp đối tượng JSON sau đây đến ứng dụng.

suppressMic

boolean

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

string

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

string

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 (OpenUrlAction)
  }
}
Các trường
destinationName

string

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 ". Tối đa 20 ký tự. Bắt buộc.

url
(deprecated)

string

Không dùng nữa. Thay vào đó, hãy sử dụng OpenUrlAction.

openUrlAction

object (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

string

Tên ý định tích hợp (ví dụ: actions.intent.TEXT) hoặc ý định được xác định trong gói hành động. Nếu ý định được chỉ định không phải là ý định tích hợp, thì ý định này chỉ được dùng cho xu hướng lời nói và dữ liệu đầu vào do Trợ lý Google cung cấp sẽ là ý định actions.intent.TEXT.

inputValueData

object

Ý đị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: 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

Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung "@type" chứa URI nhận dạng loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }.

parameterName

string

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 response can be only one of the following:
  "speechResponse": {
    object (SpeechResponse)
  },
  "richResponse": {
    object (RichResponse)
  }
  // End of list of possible types for union field response.
}
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
(deprecated)

object (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

object (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 (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.
}
Các trường
target

object (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

object (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

object (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

string

Tiêu đề của thông báo.

text

string

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 (Argument)
  },
  "locale": string
}
Các trường
userId

string

Người dùng cần nhắm mục tiêu.

intent

string

Ý định để nhắm mục tiêu.

argument

object (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

string

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ỹ.