Argument

Biểu diễn dưới dạng JSON
{
  "name": string,
  "rawText": string,
  "textValue": string,
  "status": {
    object (Status)
  },

  // Union field value can be only one of the following:
  "intValue": string,
  "floatValue": number,
  "boolValue": boolean,
  "datetimeValue": {
    object (DateTime)
  },
  "placeValue": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "structuredValue": {
    object
  }
  // End of list of possible types for union field value.
}
Các trường
name

string

tên của đối số được cung cấp cho đầu vào.

rawText

string

Văn bản thô, được nhập hoặc nói, đã cung cấp giá trị cho đối số.

textValue

string

Được chỉ định khi mẫu truy vấn bao gồm loại $org.schema.type.Text hoặc dữ liệu đầu vào dự kiến có ý định tích hợp: actions.intent.TEXT hoặc actions.intent.OPTION. Xin lưu ý rằng đối với ý định OPTION, chúng ta đặt textValue làm khoá tuỳ chọn, và rawText ở trên sẽ cho biết khoảng thô trong truy vấn của người dùng.

status

object (Status)

Chỉ định thời điểm xảy ra lỗi trong khi tính toán đối số. Ví dụ: ý định tích hợp "actions.intent.PLACE" có thể trả về trạng thái lỗi nếu người dùng từ chối cấp quyền truy cập vào thông tin vị trí của thiết bị.

Trường nhóm value. Một trong các giá trị sau được chỉ định. value chỉ có thể là một trong những trạng thái sau đây:
intValue

string (int64 format)

Được chỉ định khi mẫu truy vấn bao gồm loại $org.schema.type.Number hoặc dữ liệu đầu vào dự kiến có ý định tích hợp: "assistant.intent.action.NUMBER".

floatValue

number

Chỉ định cho ý định tích hợp: "actions.intent.NUMBER"

boolValue

boolean

Được chỉ định khi mẫu truy vấn bao gồm loại $org.schema.type.YesNo hoặc dữ liệu đầu vào dự kiến có ý định tích hợp: actions.intent.CONFIRMATION. LƯU Ý: nếu thiếu giá trị boolean, giá trị này đại diện cho false.

datetimeValue

object (DateTime)

Chỉ định cho ý định tích hợp: actions.intent.DATETIME.

placeValue

object (Location)

Được chỉ định khi mẫu truy vấn bao gồm loại $org.schema.type.Location hoặc dữ liệu đầu vào dự kiến có ý định tích hợp: "actions.intent.PLACE".

extension

object

Phần mở rộng có kiểu phụ thuộc vào đối số. Ví dụ: nếu tên đối số là SIGN_IN cho ý định actions.intent.SIGN_IN, thì phần mở rộng này sẽ chứa giá trị SignInValue.

Đố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" }.

structuredValue

object (Struct format)

Chỉ định khi Google cần truyền giá trị dữ liệu ở định dạng JSON.

Trạng thái

Loại Status xác định một mô hình lỗi logic phù hợp với nhiều môi trường lập trình, bao gồm cả API REST và API RPC. gRPC sử dụng khoá này. Mỗi thông báo Status chứa 3 phần dữ liệu: mã lỗi, thông báo lỗi và thông tin chi tiết về lỗi.

Bạn có thể tìm hiểu thêm về mô hình lỗi này và cách xử lý lỗi trong Hướng dẫn thiết kế API.

Biểu diễn dưới dạng JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Các trường
code

integer

Mã trạng thái, phải là giá trị enum của google.rpc.Code.

message

string

Một thông báo lỗi dành cho nhà phát triển, phải bằng tiếng Anh. Mọi thông báo lỗi dành cho người dùng phải được bản địa hoá và gửi trong trường google.rpc.Status.details hoặc được ứng dụng bản địa hoá.

details[]

object

Danh sách các thông báo chứa thông tin chi tiết về lỗi. Có một tập hợp các loại thông báo phổ biến để API sử dụng.

Đố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" }.

DateTime

giá trị đối số ngày và giờ được phân tích cú pháp từ hoạt động đầu vào của người dùng. Không bao gồm thông tin về múi giờ.

Biểu diễn dưới dạng JSON
{
  "date": {
    object (Date)
  },
  "time": {
    object (TimeOfDay)
  }
}
Các trường
date

object (Date)

giá trị ngày

time

object (TimeOfDay)

giá trị thời gian

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, ví dụ: ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không quan trọng. Ngày này có liên quan đến Lịch Gregorian Proleptic. Điều này có thể biểu thị:

  • Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0
  • Giá trị ngày và tháng, giá trị năm bằng 0, ví dụ: ngày kỷ niệm
  • Chỉ riêng giá trị năm, với giá trị tháng và ngày bằng 0
  • Giá trị năm và tháng, có ngày bằng 0, ví dụ: ngày hết hạn thẻ tín dụng

Các loại có liên quan là google.type.TimeOfDaygoogle.protobuf.Timestamp.

Biểu diễn dưới dạng JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Các trường
year

integer

Năm của ngày tháng. Giá trị phải từ 1 đến 9999 hoặc bằng 0 nếu chỉ định ngày không có năm.

month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 0 nếu chỉ định một năm không có tháng và ngày.

day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc bằng 0 nếu chỉ chỉ định một năm hoặc một năm và tháng không có ngày quan trọng.

TimeOfDay

Đại diện cho thời gian trong ngày. Ngày và múi giờ không quan trọng hoặc được chỉ định ở nơi khác. API có thể chọn cho phép giây nhuận. Các loại có liên quan là google.type.Dategoogle.protobuf.Timestamp.

Biểu diễn dưới dạng JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Các trường
hours

integer

Giờ trong ngày ở định dạng 24 giờ. Nên ở trong khoảng từ 0 đến 23. API có thể chọn cho phép giá trị "24:00:00" trong các trường hợp như thời gian đóng cửa của doanh nghiệp.

minutes

integer

Số phút trong giờ trong ngày. Phải từ 0 đến 59.

seconds

integer

Số giây trong phút. Thông thường phải từ 0 đến 59. API có thể cho phép giá trị 60 nếu cho phép giây nhuận.

nanos

integer

Phân số giây tính bằng nano giây. Phải từ 0 đến 999.999.999.