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

ข้อความดิบที่พิมพ์หรือพูดที่ให้ค่าสำหรับอาร์กิวเมนต์
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
  • ค่าปีและเดือนโดยมี 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