تمثيل JSON | |
---|---|
{ "name": string, "rawText": string, "textValue": string, "status": { object ( |
الحقول | ||
---|---|---|
name |
اسم الوسيطة المقدمة للإدخال. |
|
rawText |
النص الأولي، المكتوب أو الشفهي، الذي قدّم قيمة الوسيطة. |
|
textValue |
يتم تحديدها عندما يشتمل نمط طلب البحث على نوع |
|
status |
تم تحديد وقت حدوث خطأ أثناء حساب الوسيطة. على سبيل المثال، يمكن أن يعرض الغرض المضمَّن actions.intent.PLACE حالة خطأ إذا رفض المستخدم منح الإذن بالوصول إلى الموقع الجغرافي لجهازه. |
|
حقل الاتحاد value تم تحديد أحد الخيارات التالية. يمكن أن تكون السمة "value " واحدة فقط مما يلي: |
||
intValue |
يتم تحديد ذلك عندما يشتمل نمط طلب البحث على نوع $org.schema.type.Number أو إدخال متوقع يحتوي على غرض مضمّن: "assistant.intent.action.NUMBER". |
|
floatValue |
مخصص لغرض مضمّن: "actions.intent.NUMBER" |
|
boolValue |
يتم تحديدها عندما يشتمل نمط طلب البحث على نوع |
|
datetimeValue |
تم تحديد الغرض المضمَّن في الرسالة: |
|
placeValue |
يتم تحديد ذلك عندما يشتمل نمط طلب البحث على نوع $org.schema.type.Location أو الإدخال المتوقع يشتمل على غرض مضمّن: "actions.intent.PLACE". |
|
extension |
إضافة يعتمد نوعها على الوسيطة. على سبيل المثال، إذا كان اسم الوسيطة كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
|
structuredValue |
يتم تحديد هذه القيمة عندما يحتاج Google إلى تمرير قيمة البيانات بتنسيق JSON. |
الحالة
يحدد النوع Status
نموذج خطأ منطقي مناسب لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة تطبيقات REST وواجهات برمجة التطبيقات RPC. ويتم استخدامه من قِبل gRPC. تحتوي كل رسالة Status
على ثلاث أجزاء من البيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.
يمكنك معرفة المزيد حول نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.
تمثيل JSON | |
---|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
الحقول | |
---|---|
code |
رمز الحالة، الذي يجب أن يكون قيمة تعداد |
message |
رسالة خطأ موجّهة للمطوّر، ويجب أن تكون باللغة الإنجليزية. يجب ترجمة أي رسالة خطأ تظهر للمستخدمين وإرسالها في حقل |
details[] |
قائمة بالرسائل التي تتضمن تفاصيل الخطأ. هناك مجموعة شائعة من أنواع الرسائل التي يمكن أن تستخدمها واجهات برمجة التطبيقات. كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
DateTime
قيمة وسيطة التاريخ والوقت التي يتم تحليلها من البيانات التي أدخلها المستخدم لا يتضمَّن معلومات المنطقة الزمنية.
تمثيل JSON | |
---|---|
{ "date": { object ( |
الحقول | |
---|---|
date |
قيمة التاريخ |
time |
القيمة الزمنية |
التاريخ
تمثّل تاريخًا كاملاً أو جزئيًا في التقويم، مثل عيد ميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. هذا التاريخ مرتبط بالتقويم الميلادي الميلادي. يمكن أن يمثّل ذلك ما يلي:
- تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
- قيمة الشهر واليوم مع السنة صفر، على سبيل المثال ذكرى سنوية
- عام بمفرده بدون قيم شهر ويوم صفر
- قيمة سنة وشهر بدون يوم صفري، على سبيل المثال تاريخ انتهاء صلاحية بطاقة الائتمان
النوعان ذوا الصلة هما 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
يشير إلى وقت من اليوم. إما أن التاريخ والمنطقة الزمنية ليسا مهمين أو تم تحديدهما في مكان آخر. وقد تختار واجهة برمجة التطبيقات السماح بالثانية. النوعان ذوا الصلة هما google.type.Date
وgoogle.protobuf.Timestamp
.
تمثيل JSON | |
---|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
الحقول | |
---|---|
hours |
ساعات اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل وقت إغلاق النشاط التجاري. |
minutes |
دقائق من اليوم. يجب أن تتراوح القيمة بين 0 و59. |
seconds |
ثوانٍ من الوقت. يجب أن تتراوح القيمة عادةً بين 0 و59. قد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني. |
nanos |
أجزاء من الثانية بالنانو ثانية. يجب أن تتراوح القيمة بين 0 و999,999,999. |