การแสดง JSON | |
---|---|
{ "name": string, "rawText": string, "textValue": string, "status": { object ( |
ช่อง | ||
---|---|---|
name |
ชื่อของอาร์กิวเมนต์ที่ระบุสำหรับอินพุต |
|
rawText |
ข้อความดิบที่พิมพ์หรือพูดที่ให้ค่าสำหรับอาร์กิวเมนต์ |
|
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
- ค่าปีและเดือนโดยมี 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 |