Biểu diễn dưới dạng JSON | |
---|---|
{ "name": string, "rawText": string, "textValue": string, "status": { object ( |
Các trường | ||
---|---|---|
name |
tên của đối số đượ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 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 |
Đượ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: "actions.intent.NUMBER" |
|
boolValue |
Được chỉ định khi mẫu truy vấn bao gồm loại |
|
datetimeValue |
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: "actions.intent.PLACE". |
|
extension |
Phần mở rộng có kiểu phụ thuộc vào đối số. Ví dụ: nếu tên đối số là Đối tượng chứa các trường thuộc kiểu tuỳ ý. Trường bổ sung |
|
structuredValue |
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 |
Mã trạng thái, phải là giá trị enum của |
message |
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 |
details[] |
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 |
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 ( |
Các 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ụ: 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.TimeOfDay
và google.protobuf.Timestamp
.
Biểu diễn dưới dạng JSON | |
---|---|
{ "year": integer, "month": integer, "day": integer } |
Các trường | |
---|---|
year |
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 |
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 |
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.Date
và google.protobuf.Timestamp
.
Biểu diễn dưới dạng JSON | |
---|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Các trường | |
---|---|
hours |
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 |
Số phút trong giờ trong ngày. Phải từ 0 đến 59. |
seconds |
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 |
Phân số giây tính bằng nano giây. Phải từ 0 đến 999.999.999. |