การแสดง JSON | |
---|---|
{ "name": string, "rawText": string, "textValue": string, "status": { object ( |
ช่อง | ||
---|---|---|
name |
ชื่อของอาร์กิวเมนต์ที่ระบุสำหรับอินพุต |
|
rawText |
ข้อความดิบ (RAW) ที่พิมพ์หรือพูด ซึ่งให้ค่าสำหรับอาร์กิวเมนต์ |
|
textValue |
ระบุเมื่อรูปแบบประโยคมีประเภท |
|
status |
ระบุเวลาที่พบข้อผิดพลาดขณะประมวลผลอาร์กิวเมนต์ ตัวอย่างเช่น Intent ในตัว "actions.intent.PLACE" อาจแสดงสถานะข้อผิดพลาดหากผู้ใช้ปฏิเสธสิทธิ์ในการเข้าถึงตำแหน่งอุปกรณ์ |
|
ฟิลด์การรวม value มีการระบุค่าใดค่าหนึ่งต่อไปนี้ value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
intValue |
ระบุเมื่อรูปแบบประโยคมีประเภท $org.schema.type.Number หรืออินพุตที่ต้องการมี Intent ในตัวดังนี้ "assistant.intent.action.NUMBER" |
|
floatValue |
ระบุสําหรับ Intent ในตัว: "actions.intent.NUMBER" |
|
boolValue |
ระบุเมื่อรูปแบบประโยคมีประเภท |
|
datetimeValue |
ระบุสำหรับ Intent ในตัว: |
|
placeValue |
ระบุเมื่อรูปแบบประโยคมีประเภท $org.schema.type.Location หรืออินพุตที่คาดไว้มี Intent ในตัว: "actions.intent.PLACE" |
|
extension |
ส่วนขยายที่มีประเภทขึ้นอยู่กับอาร์กิวเมนต์ ตัวอย่างเช่น หากชื่ออาร์กิวเมนต์คือ ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
|
structuredValue |
ระบุเมื่อ Google ต้องส่งค่าข้อมูลในรูปแบบ JSON |
สถานะ
ประเภท Status
กำหนดโมเดลข้อผิดพลาดเชิงตรรกะที่เหมาะสำหรับสภาพแวดล้อมการเขียนโปรแกรมที่แตกต่างกัน ซึ่งรวมถึง REST API และ RPC API ใช้โดย gRPC ข้อความ Status
แต่ละข้อความจะมีข้อมูล 3 อย่าง ได้แก่ รหัสข้อผิดพลาด ข้อความแสดงข้อผิดพลาด และรายละเอียดข้อผิดพลาด
ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบข้อผิดพลาดนี้และวิธีทำงานกับรูปแบบดังกล่าวได้ในคู่มือการออกแบบ API
การแสดง JSON | |
---|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
ช่อง | |
---|---|
code |
รหัสสถานะ ซึ่งควรเป็นค่า enum ของ |
message |
ข้อความแสดงข้อผิดพลาดที่ส่งถึงนักพัฒนาซอฟต์แวร์ ซึ่งควรเป็นภาษาอังกฤษ ข้อความแสดงข้อผิดพลาดที่แสดงต่อผู้ใช้ควรแปลและส่งในช่อง |
details[] |
รายการข้อความที่มีรายละเอียดข้อผิดพลาด มีชุดประเภทข้อความที่ใช้กันโดยทั่วไปสำหรับ API ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
DateTime
ค่าอาร์กิวเมนต์วันที่และเวลาที่แยกวิเคราะห์จากข้อมูลที่ผู้ใช้ป้อน ไม่รวมข้อมูลเขตเวลา
การแสดง JSON | |
---|---|
{ "date": { object ( |
ช่อง | |
---|---|
date |
ค่าวันที่ |
time |
ค่าเวลา |
วันที่
แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด เวลาของวันและเขตเวลาจะระบุที่อื่นหรือไม่มีนัยสำคัญ วันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน Proleptic ซึ่งแสดงถึงสิ่งต่อไปนี้
- วันที่แบบเต็ม ซึ่งมีค่าปี เดือน และวันที่ไม่ใช่ศูนย์
- ค่าเดือนและวัน เท่ากับ 0 ปี เช่น วันครบรอบ
- ปีเดียวมีค่าเป็น 0 เดือนและวัน
- ค่าปีและเดือนที่เป็น 0 วัน เช่น วันที่หมดอายุของบัตรเครดิต
ประเภทที่เกี่ยวข้องคือ google.type.TimeOfDay
และ google.protobuf.Timestamp
การแสดง JSON | |
---|---|
{ "year": integer, "month": integer, "day": integer } |
ช่อง | |
---|---|
year |
ปีของวันที่ ต้องเป็น 1 ถึง 9999 หรือ 0 หากระบุวันที่โดยไม่ระบุปี |
month |
เดือนของปี ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 หากระบุปีโดยไม่มีเดือนและวัน |
day |
วันของเดือน ต้องเป็น 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 หากระบุปีอย่างเดียว หรือปีและเดือนที่วันไม่สำคัญ |
TimeOfDay
แสดงเวลาของวัน วันที่และเขตเวลาไม่มีนัยสำคัญหรือระบุไว้ในที่อื่น API อาจเลือกอนุญาตวินาทีอธิกสุรทิน ประเภทที่เกี่ยวข้องคือ google.type.Date
และ google.protobuf.Timestamp
การแสดง JSON | |
---|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
ช่อง | |
---|---|
hours |
ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ระหว่าง 0 ถึง 23 API อาจเลือกระบุค่า "24:00:00" ไว้สําหรับสถานการณ์ต่างๆ เช่น เวลาปิดทําการของธุรกิจ |
minutes |
นาทีในชั่วโมงของวัน ต้องอยู่ระหว่าง 0 ถึง 59 |
seconds |
จำนวนวินาทีของนาที ปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตค่า 60 หากอนุญาตวินาทีอธิกสุรทิน |
nanos |
เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องอยู่ระหว่าง 0 ถึง 999,999,999 |