Biểu diễn dưới dạng JSON | |
---|---|
{ "name": string, "rawText": string, "textValue": string, "status": { object ( |
Trường | ||
---|---|---|
name |
tên của đối số đang được cung cấp cho đầu vào. |
|
rawText |
Văn bản thô, được nhập hoặc nói, cung cấp giá trị cho đối số. |
|
textValue |
Được chỉ định khi mẫu truy vấn bao gồm loại |
|
status |
Chỉ định thời điểm gặp lỗi trong khi tính toán đối số. Ví dụ: ý định tích hợp "action.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 vị trí thiết bị của họ. |
|
Trường kết hợp 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 |
Đượ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 |
Chỉ định cho ý định tích hợp: "action.intent.NUMBER" |
|
boolValue |
Được chỉ định khi mẫu truy vấn bao gồm loại |
|
datetimeValue |
Được chỉ định cho ý định tích hợp: |
|
placeValue |
Đượ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: "action.intent.PLACE". |
|
extension |
Tiện ích có loại phụ thuộc vào đối số. Ví dụ: nếu tên đối số là Một đối tượng có chứa các trường thuộc loại tuỳ ý. Trường bổ sung |
|
structuredValue |
Được 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ô 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. Hàm này được gRPC sử dụng. 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 cũng như cách xử lý 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: ..., ... } ] } |
Trường | |
---|---|
code |
Mã trạng thái, phải là một giá trị enum của |
message |
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 đều phải được bản địa hoá và gửi trong trường |
details[] |
Danh sách các thông báo chứa thông tin chi tiết về lỗi. Có một nhóm loại thông báo phổ biến để API sử dụng. Một đối tượng có chứa các trường thuộc loại tuỳ ý. Trường bổ sung |
DateTime
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 múi giờ.
Biểu diễn dưới dạng JSON | |
---|---|
{ "date": { object ( |
Trường | |
---|---|
date |
giá trị ngày |
time |
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ụ: một 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 đáng kể. Ngày này có liên quan đến Lịch Gregorian Proleptic. Thông tin này có thể đại diện cho:
- Ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0
- Giá trị tháng và ngày, giá trị năm bằng 0, ví dụ: một ngày kỷ niệm
- Chỉ có năm, giá trị tháng và ngày bằng 0
- Giá trị năm và tháng, giá trị 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.TimeOfDay
và google.protobuf.Timestamp
.
Biểu diễn dưới dạng JSON | |
---|---|
{ "year": integer, "month": integer, "day": integer } |
Trường | |
---|---|
year |
Năm của ngày. 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 |
Tháng trong năm. Giá trị phải là 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 |
Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong cả năm và tháng, hoặc bằng 0 nếu chỉ định giá trị một năm hoặc một năm và tháng trong đó ngày không đáng kể. |
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.Date
và google.protobuf.Timestamp
.
Biểu diễn dưới dạng JSON | |
---|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Trường | |
---|---|
hours |
Giờ trong ngày ở định dạng 24 giờ. Nên ở từ 0 đến 23. Một API có thể chọn cho phép giá trị "24:00:00" cho các tình huống như thời gian đóng cửa doanh nghiệp. |
minutes |
Số phút trong ngày. Phải từ 0 đến 59. |
seconds |
Số giây của thời gian. Giá trị thường phải từ 0 đến 59. Một API có thể cho phép giá trị 60 nếu cho phép bật-giây. |
nanos |
Các phân số của giây tính bằng nano giây. Giá trị phải nằm trong khoảng từ 0 đến 999.999.999. |