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 أو أن يكون للإدخال المتوقع غرض مضمّن: actions.intent.TEXT أو actions.intent.OPTION. تجدر الإشارة إلى أنّه بالنسبة إلى الغرض OPTION، نُعيِّن textValue كمفتاح خيار، وستشير rawText أعلاه إلى النطاق الأولي في طلب بحث المستخدم.
status

object (Status)

تم تحديد وقت حدوث خطأ أثناء حساب الوسيطة. على سبيل المثال، يمكن أن يعرض الغرض المضمَّن actions.intent.PLACE حالة خطأ إذا رفض المستخدم منح الإذن بالوصول إلى الموقع الجغرافي لجهازه.
حقل الاتحاد value تم تحديد أحد الخيارات التالية. يمكن أن تكون السمة "value" واحدة فقط مما يلي:
intValue

string (int64 format)

يتم تحديد ذلك عندما يشتمل نمط طلب البحث على نوع $org.schema.type.Number أو إدخال متوقع يحتوي على غرض مضمّن: "assistant.intent.action.NUMBER".
floatValue

number

مخصص لغرض مضمّن: "actions.intent.NUMBER"
boolValue

boolean

يتم تحديدها عندما يشتمل نمط طلب البحث على نوع $org.schema.type.YesNo أو أن يكون للإدخال المتوقع غرض مضمّن: actions.intent.CONFIRMATION. ملاحظة: إذا كانت القيمة المنطقية مفقودة، فإنها تمثل false.
datetimeValue

object (DateTime)

تم تحديد الغرض المضمَّن في الرسالة: actions.intent.DATETIME.
placeValue

object (Location)

يتم تحديد ذلك عندما يشتمل نمط طلب البحث على نوع $org.schema.type.Location أو الإدخال المتوقع يشتمل على غرض مضمّن: "actions.intent.PLACE".
extension

object

إضافة يعتمد نوعها على الوسيطة. على سبيل المثال، إذا كان اسم الوسيطة SIGN_IN للغرض actions.intent.SIGN_IN، تحتوي هذه الإضافة على القيمة SignInValue.

كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي "@type" على معرّف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }
structuredValue

object (Struct format)

يتم تحديد هذه القيمة عندما يحتاج Google إلى تمرير قيمة البيانات بتنسيق JSON.

الحالة

يحدد النوع Status نموذج خطأ منطقي مناسب لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة تطبيقات REST وواجهات برمجة التطبيقات RPC. ويتم استخدامه من قِبل gRPC. تحتوي كل رسالة Status على ثلاث أجزاء من البيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.

يمكنك معرفة المزيد حول نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.

تمثيل JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
الحقول
code

integer

رمز الحالة، الذي يجب أن يكون قيمة تعداد google.rpc.Code
message

string

رسالة خطأ موجّهة للمطوّر، ويجب أن تكون باللغة الإنجليزية. يجب ترجمة أي رسالة خطأ تظهر للمستخدمين وإرسالها في حقل google.rpc.Status.details أو ترجمتها من خلال البرنامج.
details[]

object

قائمة بالرسائل التي تتضمن تفاصيل الخطأ. هناك مجموعة شائعة من أنواع الرسائل التي يمكن أن تستخدمها واجهات برمجة التطبيقات.

كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي "@type" على معرّف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }

DateTime

قيمة وسيطة التاريخ والوقت التي يتم تحليلها من البيانات التي أدخلها المستخدم لا يتضمَّن معلومات المنطقة الزمنية.

تمثيل JSON 
{
  "date": {
    object (Date)
  },
  "time": {
    object (TimeOfDay)
  }
}
الحقول
date

object (Date)

قيمة التاريخ
time

object (TimeOfDay)

القيمة الزمنية

التاريخ

تمثّل تاريخًا كاملاً أو جزئيًا في التقويم، مثل عيد ميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. هذا التاريخ مرتبط بالتقويم الميلادي الميلادي. يمكن أن يمثّل ذلك ما يلي:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
  • قيمة الشهر واليوم مع السنة صفر، على سبيل المثال ذكرى سنوية
  • عام بمفرده بدون قيم شهر ويوم صفر
  • قيمة سنة وشهر بدون يوم صفري، على سبيل المثال تاريخ انتهاء صلاحية بطاقة الائتمان

النوعان ذوا الصلة هما 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

يشير إلى وقت من اليوم. إما أن التاريخ والمنطقة الزمنية ليسا مهمين أو تم تحديدهما في مكان آخر. وقد تختار واجهة برمجة التطبيقات السماح بالثانية. النوعان ذوا الصلة هما google.type.Date وgoogle.protobuf.Timestamp.

تمثيل JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
الحقول
hours

integer

ساعات اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل وقت إغلاق النشاط التجاري.
minutes

integer

دقائق من اليوم. يجب أن تتراوح القيمة بين 0 و59.
seconds

integer

ثوانٍ من الوقت. يجب أن تتراوح القيمة عادةً بين 0 و59. قد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني.
nanos

integer

أجزاء من الثانية بالنانو ثانية. يجب أن تتراوح القيمة بين 0 و999,999,999.