Argument

การแสดง 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.
}
ช่อง
name

string

ชื่อของอาร์กิวเมนต์ที่ระบุสำหรับอินพุต
rawText

string

ข้อความดิบ (RAW) ที่พิมพ์หรือพูด ซึ่งให้ค่าสำหรับอาร์กิวเมนต์
textValue

string

ระบุเมื่อรูปแบบประโยคมีประเภท $org.schema.type.Text หรืออินพุตที่คาดไว้มี Intent ในตัว: actions.intent.TEXT หรือ actions.intent.OPTION โปรดทราบว่าสำหรับ Intent ของ OPTION เราตั้งค่า textValue เป็นคีย์ตัวเลือก ส่วน rawText ด้านบนจะระบุระยะเวลาดิบในคำค้นหาของผู้ใช้
status

object (Status)

ระบุเวลาที่พบข้อผิดพลาดขณะประมวลผลอาร์กิวเมนต์ ตัวอย่างเช่น Intent ในตัว "actions.intent.PLACE" อาจแสดงสถานะข้อผิดพลาดหากผู้ใช้ปฏิเสธสิทธิ์ในการเข้าถึงตำแหน่งอุปกรณ์
ฟิลด์การรวม value มีการระบุค่าใดค่าหนึ่งต่อไปนี้ value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
intValue

string (int64 format)

ระบุเมื่อรูปแบบประโยคมีประเภท $org.schema.type.Number หรืออินพุตที่ต้องการมี Intent ในตัวดังนี้ "assistant.intent.action.NUMBER"
floatValue

number

ระบุสําหรับ Intent ในตัว: "actions.intent.NUMBER"
boolValue

boolean

ระบุเมื่อรูปแบบประโยคมีประเภท $org.schema.type.YesNo หรืออินพุตที่คาดไว้มี Intent ในตัว: actions.intent.CONFIRMATION หมายเหตุ: หากไม่มีค่าบูลีน ค่านี้แสดงถึง false
datetimeValue

object (DateTime)

ระบุสำหรับ Intent ในตัว: actions.intent.DATETIME
placeValue

object (Location)

ระบุเมื่อรูปแบบประโยคมีประเภท $org.schema.type.Location หรืออินพุตที่คาดไว้มี Intent ในตัว: "actions.intent.PLACE"
extension

object

ส่วนขยายที่มีประเภทขึ้นอยู่กับอาร์กิวเมนต์ ตัวอย่างเช่น หากชื่ออาร์กิวเมนต์คือ SIGN_IN สำหรับ Intent actions.intent.SIGN_IN ส่วนขยายนี้จะมีค่า SignInValue

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }
structuredValue

object (Struct format)

ระบุเมื่อ Google ต้องส่งค่าข้อมูลในรูปแบบ JSON

สถานะ

ประเภท Status กำหนดโมเดลข้อผิดพลาดเชิงตรรกะที่เหมาะสำหรับสภาพแวดล้อมการเขียนโปรแกรมที่แตกต่างกัน ซึ่งรวมถึง REST API และ RPC API ใช้โดย gRPC ข้อความ Status แต่ละข้อความจะมีข้อมูล 3 อย่าง ได้แก่ รหัสข้อผิดพลาด ข้อความแสดงข้อผิดพลาด และรายละเอียดข้อผิดพลาด

ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบข้อผิดพลาดนี้และวิธีทำงานกับรูปแบบดังกล่าวได้ในคู่มือการออกแบบ API

การแสดง JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
ช่อง
code

integer

รหัสสถานะ ซึ่งควรเป็นค่า enum ของ google.rpc.Code
message

string

ข้อความแสดงข้อผิดพลาดที่ส่งถึงนักพัฒนาซอฟต์แวร์ ซึ่งควรเป็นภาษาอังกฤษ ข้อความแสดงข้อผิดพลาดที่แสดงต่อผู้ใช้ควรแปลและส่งในช่อง google.rpc.Status.details หรือไคลเอ็นต์แปล
details[]

object

รายการข้อความที่มีรายละเอียดข้อผิดพลาด มีชุดประเภทข้อความที่ใช้กันโดยทั่วไปสำหรับ API

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }

DateTime

ค่าอาร์กิวเมนต์วันที่และเวลาที่แยกวิเคราะห์จากข้อมูลที่ผู้ใช้ป้อน ไม่รวมข้อมูลเขตเวลา

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "time": {
    object (TimeOfDay)
  }
}
ช่อง
date

object (Date)

ค่าวันที่
time

object (TimeOfDay)

ค่าเวลา

วันที่

แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด เวลาของวันและเขตเวลาจะระบุที่อื่นหรือไม่มีนัยสำคัญ วันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน Proleptic ซึ่งแสดงถึงสิ่งต่อไปนี้

  • วันที่แบบเต็ม ซึ่งมีค่าปี เดือน และวันที่ไม่ใช่ศูนย์
  • ค่าเดือนและวัน เท่ากับ 0 ปี เช่น วันครบรอบ
  • ปีเดียวมีค่าเป็น 0 เดือนและวัน
  • ค่าปีและเดือนที่เป็น 0 วัน เช่น วันที่หมดอายุของบัตรเครดิต

ประเภทที่เกี่ยวข้องคือ google.type.TimeOfDay และ google.protobuf.Timestamp

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องเป็น 1 ถึง 9999 หรือ 0 หากระบุวันที่โดยไม่ระบุปี
month

integer

เดือนของปี ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 หากระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ต้องเป็น 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 หากระบุปีอย่างเดียว หรือปีและเดือนที่วันไม่สำคัญ

TimeOfDay

แสดงเวลาของวัน วันที่และเขตเวลาไม่มีนัยสำคัญหรือระบุไว้ในที่อื่น API อาจเลือกอนุญาตวินาทีอธิกสุรทิน ประเภทที่เกี่ยวข้องคือ google.type.Date และ google.protobuf.Timestamp

การแสดง JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
ช่อง
hours

integer

ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ควรอยู่ระหว่าง 0 ถึง 23 API อาจเลือกระบุค่า "24:00:00" ไว้สําหรับสถานการณ์ต่างๆ เช่น เวลาปิดทําการของธุรกิจ
minutes

integer

นาทีในชั่วโมงของวัน ต้องอยู่ระหว่าง 0 ถึง 59
seconds

integer

จำนวนวินาทีของนาที ปกติต้องอยู่ระหว่าง 0 ถึง 59 API อาจอนุญาตค่า 60 หากอนุญาตวินาทีอธิกสุรทิน
nanos

integer

เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องอยู่ระหว่าง 0 ถึง 999,999,999