Method: fulfill

{
  "name": string
}

string

اختياريّ. اسم المعالج.

{
  "name": string,
  "params": {
    string: {
      object (IntentParameterValue)
    },
    ...
  },
  "query": string
}

string

مطلوب. اسم آخر غرض مطابق.

map (key: string, value: object (IntentParameterValue))

مطلوب. تمثل المَعلمات المحدَّدة كجزء من مطابقة النية. هذه خريطة لاسم المَعلمة المحدّدة بقيمة المَعلمة المحدّدة من إدخال المستخدم. ستظهر هنا جميع المَعلمات المحدّدة في الغرض المطابق والمحدد.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

string

اختياريّ. الإدخال المكتوب أو المنطوق من المستخدم النهائي الذي يطابق هذا الهدف ستتم تعبئة هذا الحقل عند مطابقة هدف، استنادًا إلى إدخال المستخدم.

{
  "original": string,
  "resolved": value
}

string

مطلوب. قيمة النص الأصلية المستخرجة من كلام المستخدم.

value (Value format)

مطلوب. القيمة المنظَّمة للمَعلمة المستخرجة من البيانات التي أدخلها المستخدم لن تتم تعبئة هذا الحقل إلا إذا تم تحديد المعلمة في الغرض المطابق، وكان من الممكن تحديد قيمة المعلمة أثناء مطابقة النية.

{
  "name": string,
  "slotFillingStatus": enum (SlotFillingStatus),
  "slots": {
    string: {
      object (Slot)
    },
    ...
  },
  "next": {
    object (NextScene)
  }
}

string

مطلوب. اسم المشهد الحالي

enum (SlotFillingStatus)

مطلوب. الحالة الحالية لملء الخانات هذا الحقل للقراءة فقط.

map (key: string, value: object (Slot))

الخانات المرتبطة بالمشهد الحالي لا يمكن لردود المعالج عرض خانات لم يتم إرسالها في الطلب.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

object (NextScene)

اختياريّ. المعلومات على المشهد المطلوب تنفيذها في المرة التالية

{
  "mode": enum (SlotMode),
  "status": enum (SlotStatus),
  "value": value,
  "updated": boolean,
  "prompt": {
    object (Prompt)
  }
}

enum (SlotMode)

وضع الخانة (مطلوب أو اختياري). يمكن ضبطه من قِبل المطوّر.

enum (SlotStatus)

حالة الخانة.

value (Value format)

قيمة الخانة. سيؤدي تغيير هذه القيمة في الاستجابة إلى تعديل القيمة في ملء الخانة.

boolean

يشير إلى ما إذا تم جمع قيمة الخانة في آخر منعطف. هذا الحقل للقراءة فقط.

object (Prompt)

اختياريّ. يتم إرسال هذا الطلب إلى المستخدم عند الحاجة لملء الفترة المطلوبة. يلغي هذا الطلب الطلب الحالي المحدَّد في وحدة التحكّم. لا يتم تضمين هذا الحقل في طلب الرد التلقائي على الويب.

{
  "override": boolean,
  "firstSimple": {
    object (Simple)
  },
  "content": {
    object (Content)
  },
  "lastSimple": {
    object (Simple)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "link": {
    object (Link)
  },
  "canvas": {
    object (Canvas)
  },
  "orderUpdate": {
    object (OrderUpdate)
  }
}

boolean

اختياريّ. وضع لكيفية دمج هذه الرسائل مع الرسائل المحددة مسبقًا. "صحيح" يمحو جميع الرسائل المحددة سابقًا (الأول والأخير البسيط، ورابط المحتوى والاقتراحات، ولوحة الرسم) ويضيف الرسائل المحددة في هذا الطلب. "خطأ" تضيف الرسائل المحدَّدة في هذا الطلب إلى الرسائل المحدَّدة في الردود السابقة. ترك هذا الحقل على "خطأ" يمكّن أيضًا الإلحاق ببعض الحقول داخل الطلبات البسيطة ومطالبة الاقتراحات ومطالبة لوحة الرسم (جزء من مطالبة المحتوى). يتم دائمًا استبدال رسائل "المحتوى" و"الروابط" إذا تم تحديدها في الطلب. القيمة التلقائية هي "خطأ".

object (Simple)

اختياريّ. أول رد صوتي ونص فقط.

object (Content)

اختياريّ. محتوى مثل بطاقة أو قائمة أو وسائط لعرضها للمستخدم.

object (Simple)

اختياريّ. آخر رد صوتي ونص فقط.

object (Suggestion)

اختياريّ. سيتم عرض الاقتراحات للمستخدم والتي ستظهر دائمًا في نهاية الردّ. إذا تم "تجاوز" في الطلب الذي يتضمن القيمة "false"، ستتم إضافة العناوين المحددة في هذا الحقل إلى العناوين المحددة في أي طلبات اقتراحات محددة مسبقًا، وستتم إزالة القيم المكررة.

object (Link)

اختياريّ. شريحة اقتراح إضافية يمكن أن تربط بالتطبيق أو الموقع الإلكتروني المرتبط. سيتم عرض الشريحة بعنوان "Open (name)" (فتح (اسم)). 20 حرفًا كحد أقصى.

object (Canvas)

اختياريّ. يمثل هذا النوع رد لوحة رسم تفاعليًا يتم إرساله إلى المستخدم.

object (OrderUpdate)

يتجاوب "الإجراء الاختياري" باستخدام أمر OrderUpdate (تحديث الطلب) بعد استلام الطلب أثناء تدفق المعاملات. عند استلام هذا الطلب، تسجِّل Google هذا التعديل للطلب، وفي حال نجاح هذا الإجراء، تعرض بطاقة إيصال الاستلام مع تحويل النص إلى كلام المُرسل على أجهزة العرض.

{
  "speech": string,
  "text": string
}

string

اختياريّ. تمثل الكلام الذي سيتم قوله للمستخدم. يمكن أن يكون SSML أو تحويل النص إلى كلام. إذا تم "تجاوز" في المطالبة التي تحتوي على "صحيح"، يحل الكلام المحدد في هذا الحقل محل كلام الطلب البسيط السابق. يُرجى الاطّلاع على https://developers.google.com/assistant/conversational/ssml.

string

نص اختياري للعرض في فقاعة المحادثة. وفي حال عدم إتاحته، سيتم عرض عرض لحقل الكلام أعلاه. يقتصر على 640 حرفًا. إذا تم "تجاوز" في المطالبة التي تحتوي على "صحيح"، يتم استبدال النص المحدد في هذا الحقل بنص الطلب البسيط السابق.

{

  // Union field content can be only one of the following:
  "card": {
    object (Card)
  },
  "image": {
    object (Image)
  },
  "table": {
    object (Table)
  },
  "media": {
    object (Media)
  },
  "collection": {
    object (Collection)
  },
  "list": {
    object (List)
  },
  "collectionBrowse": {
    object (CollectionBrowse)
  }
  // End of list of possible types for union field content.
}

object (Card)

بطاقة أساسية

object (Image)

صورة.

object (Table)

بطاقة جدول.

object (Media)

استجابة تشير إلى مجموعة من الوسائط التي سيتم تشغيلها.

object (Collection)

بطاقة تعرض مجموعة من الخيارات للاختيار من بينها.

object (List)

بطاقة تعرض قائمة بالخيارات للاختيار منها.

object (CollectionBrowse)

بطاقة تعرض مجموعة من صفحات الويب المراد فتحها

{
  "title": string,
  "subtitle": string,
  "text": string,
  "image": {
    object (Image)
  },
  "imageFill": enum (ImageFill),
  "button": {
    object (Link)
  }
}

string

العنوان العام للبطاقة. اختياريّ.

string

اختياريّ.

string

النص الأساسي للبطاقة. تتيح مجموعة محدودة من بنية markdown للتنسيق. مطلوب، ما لم تكن الصورة موجودة.

object (Image)

صورة الجزء الرئيسي للبطاقة تم تثبيت الارتفاع على 192 وحدة بكسل مستقلة الكثافة (dp). اختياريّ.

enum (ImageFill)

طريقة ملء خلفية الصورة اختياريّ.

object (Link)

زر برابط خارجي اختياريّ.

{
  "url": string,
  "alt": string,
  "height": integer,
  "width": integer
}

string

عنوان URL المصدر الخاص بالصورة يمكن أن تكون الصور بتنسيق JPG وPNG وGIF (متحرّكة وغير متحركة). مثلاً: https://www.agentx.com/logo.png مطلوب.

string

وصف نصي للصورة التي سيتم استخدامها لتسهيل الاستخدام، على سبيل المثال قارئات الشاشة. مطلوب.

integer

ارتفاع الصورة بالبكسل. اختياريّ.

integer

عرض الصورة بالبكسل. اختياريّ.

{
  "name": string,
  "open": {
    object (OpenUrl)
  }
}

string

اسم الرابط 20 حرفًا كحد أقصى

object (OpenUrl)

ماذا يحدث عندما يفتح المستخدم الرابط؟

{
  "url": string,
  "hint": enum (UrlHint)
}

string

حقل عنوان URL الذي يمكن أن يكون أيًا مما يلي: - http/https عناوين URL لفتح تطبيق مرتبط بتطبيق أو صفحة ويب

enum (UrlHint)

يشير هذا الحقل إلى تلميح لنوع عنوان URL.

{
  "title": string,
  "subtitle": string,
  "image": {
    object (Image)
  },
  "columns": [
    {
      object (TableColumn)
    }
  ],
  "rows": [
    {
      object (TableRow)
    }
  ],
  "button": {
    object (Link)
  }
}

string

تمثّل هذه السمة العنوان العام للجدول. اختياري، ولكن يجب تعيينه في حال تعيين الترجمة.

string

عنوان فرعي للجدول. اختياريّ.

object (Image)

صورة مرتبطة بالجدول اختياريّ.

object (TableColumn)

عناوين الأعمدة ومحاذاة الأعمدة

object (TableRow)

بيانات الصف في الجدول يمكن ضمان عرض أول 3 صفوف، ولكن قد يتم اقتصاص الصفوف الأخرى على أسطح معيّنة. يُرجى إجراء الاختبار باستخدام المحاكي لمعرفة الصفوف التي سيتم عرضها لسطح معيَّن. في مساحات العرض التي تتيح استخدام ميزة WEB_BROWSER، يمكنك توجيه المستخدم إلى صفحة ويب تحتوي على مزيد من البيانات.

object (Link)

زرّ

{
  "header": string,
  "align": enum (HorizontalAlignment)
}

string

نص عنوان العمود

enum (HorizontalAlignment)

محاذاة أفقية لعمود w.r.t المحتوى إذا لم يتم تحديد ذلك، ستتم محاذاة المحتوى مع الحافة الأمامية.

{
  "cells": [
    {
      object (TableCell)
    }
  ],
  "divider": boolean
}

object (TableCell)

الخلايا في هذا الصف. يتم ضمان عرض أول 3 خلايا، ولكن قد يتم اقتصاص الخلايا الأخرى على أسطح معيّنة. يُرجى الاختبار باستخدام المحاكي لمعرفة الخلايا التي سيتم عرضها على سطح معيَّن.

boolean

يشير إلى ما إذا كان يجب أن يكون هناك مُقسّم بعد كل صف.

{
  "text": string
}

string

المحتوى النصي للخلية.

{
  "mediaType": enum (MediaType),
  "startOffset": string,
  "optionalMediaControls": [
    enum (OptionalMediaControls)
  ],
  "mediaObjects": [
    {
      object (MediaObject)
    }
  ],
  "repeatMode": enum (RepeatMode),
  "firstMediaObjectIndex": integer
}

enum (MediaType)

string (Duration format)

إزاحة بدء كائن الوسائط الأول.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى، ويتم إنهاؤها بعبارة "s". مثال: "3.5s"

enum (OptionalMediaControls)

أنواع عناصر التحكم الاختيارية في الوسائط التي يمكن أن تدعمها جلسة الاستجابة للوسائط هذه. في حال ضبطها، سيتم إرسال الطلب إلى جهة خارجية عند وقوع حدث معيّن للوسائط. في حال ترك هذه السياسة بدون ضبط، يجب أن يتعامل الطرف الثالث مع نوعَي التحكّم التلقائيَّين، "تم الانتهاء" و"تعذّر الإجراء".

object (MediaObject)

قائمة كائنات الوسائط

enum (RepeatMode)

وضع التكرار لقائمة عناصر الوسائط.

integer

فهرس يستند إلى 0 لأول عنصر وسائط في MediaObjects يتم تشغيله. إذا كان المحتوى غير محدّد أو صفرًا أو خارج الحدود، يبدأ التشغيل من أول عنصر وسائط في MediaObjects.

{
  "name": string,
  "description": string,
  "url": string,
  "image": {
    object (MediaImage)
  }
}

string

اسم كائن الوسائط هذا.

string

وصف عنصر الوسائط هذا.

string

تمثّل هذه السمة عنوان URL الذي يشير إلى محتوى الوسائط. يجب استضافة ملفات MP3 على خادم ويب وأن تكون متاحة للجميع من خلال عنوان URL يستخدم HTTPS. يمكن البث المباشر بتنسيق MP3 فقط.

object (MediaImage)

الصورة التي سيتم عرضها مع بطاقة الوسائط.

{

  // Union field image can be only one of the following:
  "large": {
    object (Image)
  },
  "icon": {
    object (Image)
  }
  // End of list of possible types for union field image.
}

object (Image)

صورة كبيرة، مثل غلاف الألبوم، وما إلى ذلك

object (Image)

رمز صورة صغير يتم عرضه على يمين العنوان. ويتم تغيير حجمها إلى 36×36 بكسل مستقل الكثافة.

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (CollectionItem)
    }
  ],
  "imageFill": enum (ImageFill)
}

string

تمثّل هذه السمة عنوان المجموعة. اختياريّ.

string

العنوان الفرعي للمجموعة. اختياريّ.

object (CollectionItem)

تمثّل هذه السمة قائمة من العناصر. ويمكن أن تكون الحد الأدنى 2 و10 كحد أقصى.

enum (ImageFill)

طريقة ملء خلفيات الصور الخاصة بعناصر المجموعة اختياريّ.

{
  "key": string
}

string

مطلوب. مفتاح NLU الذي يتطابق مع اسم مفتاح الإدخال في النوع المرتبط.

{
  "title": string,
  "subtitle": string,
  "items": [
    {
      object (ListItem)
    }
  ]
}

string

عنوان القائمة اختياريّ.

string

العنوان الفرعي للقائمة. اختياريّ.

object (ListItem)

تمثّل هذه السمة قائمة من العناصر. ويمكن أن تكون الحد الأدنى 2 و30 كحد أقصى.

{
  "key": string
}

string

مطلوب. مفتاح NLU الذي يتطابق مع اسم مفتاح الإدخال في النوع المرتبط.

{
  "items": [
    {
      object (Item)
    }
  ],
  "imageFill": enum (ImageFill)
}

object (Item)

تمثّل هذه السمة قائمة من العناصر. ويمكن أن تكون الحد الأدنى 2 و10 كحد أقصى.

enum (ImageFill)

خيار عرض نوع الصورة

{
  "title": string,
  "description": string,
  "footer": string,
  "image": {
    object (Image)
  },
  "openUriAction": {
    object (OpenUrl)
  }
}

string

مطلوب. عنوان عنصر المجموعة

string

تمثّل هذه السمة وصف عنصر المجموعة.

string

نص التذييل لعنصر المجموعة، ويتم عرضه أسفل الوصف. سطر واحد من النص، تم اقتطاعه بعلامة الحذف.

object (Image)

صورة للسلعة في المجموعة

object (OpenUrl)

مطلوب. معرف موارد منتظم (URI) للفتح إذا تم تحديد العنصر.

{
  "title": string
}

string

مطلوب. النص المعروض في شريحة الاقتراح عند النقر على هذا النص، سيتم نشره مرة أخرى على المحادثة حرفيًا كما لو كان المستخدم قد كتبه. يجب أن يكون كل عنوان فريدًا من بين مجموعة شرائح الاقتراحات. 25 حرفًا بحد أقصى

{
  "url": string,
  "data": [
    value
  ],
  "suppressMic": boolean,
  "continuousMatchConfig": {
    object (ContinuousMatchConfig)
  }
}

string

عنوان URL لتطبيق الويب التفاعلي للوحة الرسم المطلوب تحميله. وفي حال ترك السياسة بدون ضبط، ستتم إعادة استخدام عنوان URL من لوحة الرسم النشطة الحالية.

value (Value format)

اختياريّ. يتم تمرير بيانات JSON إلى صفحة الويب للتجربة الشاملة كفعالية. إذا تم "تجاوز" الحقل في الطلب الذي يتضمّن الطلب هو "false" ستتم إضافة قيم البيانات المحددة في طلب لوحة الرسم هذا بعد قيم البيانات المحددة في طلبات لوحة الرسم السابقة.

boolean

اختياريّ. القيمة التلقائية: false.

object (ContinuousMatchConfig)

الإعدادات المستخدمة لبدء وضع المطابقة المستمرة

{
  "expectedPhrases": [
    {
      object (ExpectedPhrase)
    }
  ],
  "durationSeconds": integer
}

object (ExpectedPhrase)

كل العبارات المتوقّعة المحتملة خلال جلسة "وضع المطابقة المستمرة" هذه

integer

المدة الزمنية لمواصلة تفعيل "وضع المطابقة المستمرة" في حال تحديده، سيتم إغلاق الميكروفون عند انتهاء الوقت. الحد الأقصى المسموح به للقيمة هو 180.

{
  "phrase": string,
  "alternativePhrases": [
    string
  ]
}

string

العبارة المطلوب مطابقتها أثناء جلسة وضع المطابقة المستمرة

string

قد يخطئ نموذج الكلام في التعرف على بعض العبارات حتى مع تحيز الكلام. يتيح هذا للمطوّرين تحديد عوامل تشغيل بديلة للمصطلحات المتجانسة.

{
  "type": enum (Type),
  "order": {
    object (Order)
  },
  "updateMask": string,
  "userNotification": {
    object (UserNotification)
  },
  "reason": string
}

enum (Type)

متوقّفة نهائيًا: يُرجى استخدام OrderUpdate.update_mask بدلاً من ذلك. إذا كان النوع = SNAPSHOT، يجب أن يكون OrderUpdate.order هو الطلب بالكامل. إذا كان النوع = ORDER_STATUS، يكون هذا هو التغيير في حالة مستوى الطلب. يتم فقط اختيار Order.last_update_time وهذه الحالة العمودية. ملاحظة: لا يتوافق type.ORDER_STATUS إلا مع تحديثات حالة PercahaseOrderExtension، ولا توجد خطة لتوسيع هذا الدعم. بدلاً من ذلك، ننصح باستخدام updateMask لأنّه أكثر عمومية وقابلية للتوسُّع ويمكن استخدامه لجميع المجالات.

object (Order)

string (FieldMask format)

ملاحظة: تتوفّر بعض الاقتراحات أو الاقتراحات للحقول الخاصة التالية: 1. سيتم دائمًا تحديث order.last_update_time كجزء من طلب التعديل. 2- سيتم تجاهل order.create_time وorder.google_order_id وorder.merchant_order_id في حال توفيرها كجزء من updateMask.

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"

object (UserNotification)

في حال تحديد هذا الخيار، سيتم عرض إشعار للمستخدم بالعنوان والنص المحدَّدين. تحديد الإشعار هو اقتراح للإشعار وليس مضمونًا أن يؤدي إلى إشعار.

string

سبب التغيير/التحديث.

{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}

string

مُعرّف الطلب الذي قدمته Google.

string

مطلوب: مُعرّف الطلب الداخلي الذي عيّنه التاجر. ويجب أن يكون هذا المعرّف فريدًا ومطلوبًا للعمليات اللاحقة الخاصة بتعديل الطلب. قد يتم ضبط هذا المعرّف على googleOrderId المقدَّم أو أي قيمة فريدة أخرى. يُرجى العِلم أنّ المعرّف المقدَّم للمستخدمين هو uservisibleOrderId، وهو قد يكون قيمة مختلفة وسهلة الاستخدام. الحد الأقصى المسموح به للطول هو 128 حرفًا.

string

رقم التعريف الموجَّه للمستخدم الذي يشير إلى الطلب الحالي يجب أن يكون هذا المعرّف متوافقًا مع المعرّف المعروض لهذا الطلب في السياقات الأخرى، بما في ذلك المواقع الإلكترونية والتطبيقات والبريد الإلكتروني.

string

متوقّفة نهائيًا: استخدِم حالة إضافات الطلب بدلاً منها. تصنيف مرئي للمستخدم للحالة التي تم فيها تقديم هذا الطلب

object (UserInfo)

معلومات عن المشتري

object (Image)

الصورة المرتبطة بالطلب

string (Timestamp format)

مطلوب: تاريخ ووقت إنشاء الطلب.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

تاريخ ووقت آخر تعديل للطلب مطلوب لتحديث OrderUpdate.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

object (Merchant)

التاجر الذي سهّل عملية الدفع وقد يختلف هذا الإجراء عن موفّر خدمة على مستوى العنصر. مثال: طلب Expedia مع عنصر من ANA

object (Contents)

المطلوب: محتوى الطلب، وهو مجموعة من تفاصيل الإعلان

object (PriceAttribute)

الأسعار والخصومات والضرائب وما إلى ذلك

object (Action)

متابعة الإجراءات على مستوى الطلب

object (PaymentData)

البيانات المتعلّقة بالدفع في الطلب

string

رابط إلى بنود الخدمة التي تنطبق على الطلب أو الطلب المقترَح

string

تم إرفاق الملاحظات بالطلب.

object (Promotion)

تمثّل هذه السمة جميع العروض الترويجية المرتبطة بهذا الطلب.

object (Disclosure)

الإفصاحات المرتبطة بهذا الطلب

object

متوقّفة نهائيًا: استخدِم مواضع الإعلانات بدلاً منها. سيتم تطبيق هذه السمات على جميع تفاصيل الإعلانات، ما لم يتم إلغاؤها في بعض تفاصيل الإعلانات. يجب أن يتطابق هذا العمود مع النوع العمودي على مستوى العنصر. القيم المحتملة: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

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

object (PurchaseOrderExtension)

أمر الشراء

object (TicketOrderExtension)

طلب التذكرة

{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}

string

البريد الإلكتروني للمستخدم، على سبيل المثال: janedoe@gmail.com.

string

الاسم الأول للمستخدم

string

اسم العائلة للمستخدم

string

قد يكون الاسم المعروض للمستخدم مختلفًا عن الاسم الأول أو اسم العائلة.

object (PhoneNumber)

أرقام هواتف المستخدم

{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}

string

رقم الهاتف بتنسيق E.164، على النحو المحدّد في توصية E.164 من الاتحاد الدولي للاتصالات (ITU). رابط wiki: https://en.wikipedia.org/wiki/E.164

string

لا يتم توحيد الامتداد في توصيات الاتحاد الدولي للاتصالات، باستثناء ما يتم تعريفه كسلسلة من الأرقام التي يصل طولها إلى 40 رقمًا كحد أقصى. ويُعرَّف بأنه سلسلة هنا لاستيعاب الاستخدام المحتمل لصفر بادئ في الإضافة (للمؤسسات الحرية الكاملة في تنفيذ ذلك، حيث لا يوجد معيار محدد). بخلاف الأرقام، هناك بعض رموز الطلب الأخرى مثل "," (الإشارة إلى الانتظار) قد يتم تخزينها هنا. على سبيل المثال، في الملحق xxx-xxx-xxxx 123، "123" هي الإضافة.

string

رمز اختيار مشغّل شبكة الجوّال المفضَّل عند الاتصال برقم الهاتف هذا محليًا. ويشمل ذلك أيضًا الرموز التي يلزم الاتصال بها في بعض البلدان عند الاتصال من الخطوط الأرضية إلى الهواتف الجوّالة، أو العكس. على سبيل المثال، في كولومبيا، تشير "3" يجب الاتصال به قبل رقم الهاتف نفسه عند الاتصال من هاتف جوال إلى هاتف أرضي محلي والعكس صحيح. https://en.wikipedia.org/wiki/Telephone_numbers_in_Colombia https://en.wikipedia.org/wiki/Brazilian_Carrier_Selection_Code

لاحظ أن هذا هو "المفضل" الرمز، مما يعني أن رموزًا أخرى قد تعمل أيضًا.

{
  "url": string,
  "accessibilityText": string,
  "height": integer,
  "width": integer
}

string

عنوان URL المصدر الخاص بالصورة يمكن أن تكون الصور بتنسيق JPG وPNG وGIF (متحرّكة وغير متحركة). مثلاً: https://www.agentx.com/logo.png مطلوب.

string

وصف نصي للصورة التي سيتم استخدامها لتسهيل الاستخدام، على سبيل المثال قارئات الشاشة. مطلوب.

integer

ارتفاع الصورة بالبكسل. اختياريّ.

integer

عرض الصورة بالبكسل. اختياريّ.

{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}

string

معرّف اختياري تم تخصيصه للتاجر، إن توفّر.

string

اسم التاجر، مثل "خبز البانيرا".

object (Image)

الصورة المرتبطة بالتاجر

object (PhoneNumber)

أرقام هواتف التاجر

object (Location)

عنوان التاجر.

{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}

object (LatLng)

الإحداثيات الجغرافية يتطلب [DEVICE_PRECISE_LOCATION] إذن [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

string

العنوان المعروض، على سبيل المثال: "1600 Amphitheatre Pkwy, Mountain View, CA 94043". يتطلب [DEVICE_PRECISE_LOCATION] إذن [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION].

string

الرمز البريدي. يتطلب [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] أو [DEVICE_COARSE_LOCATION] إذن [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

string

المدينة. يتطلب [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] أو [DEVICE_COARSE_LOCATION] إذن [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

object (PostalAddress)

العنوان البريدي. يتطلب [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] أو [DEVICE_COARSE_LOCATION] إذن [google.actions.v2.Permission.DEVICE_COARSE_LOCATION].

string

اسم المكان.

string

رقم هاتف الموقع الجغرافي، على سبيل المثال رقم جهة الاتصال لموقع النشاط التجاري أو رقم الهاتف الخاص بموقع التسليم.

string

ملاحظات حول الموقع الجغرافي

string

يتم استخدام PlaceId مع Places API لاسترجاع تفاصيل المكان. يمكنك الاطّلاع على https://developers.google.com/places/web-service/place-id.

{
  "latitude": number,
  "longitude": number
}

number

خط العرض بالدرجات. يجب أن يكون في النطاق [ -90.0، +90.0].

number

خط الطول بالدرجات. يجب أن يكون في النطاق [ -180.0، +180.0].

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

تمثّل هذه السمة مراجعة المخطط لـ PostalAddress. يجب الضبط على 0، وهي أحدث مراجعة.

يجب أن تكون جميع النُسخ السابقة متوافقة مع الإصدارات القديمة.

string

مطلوب. رمز CLDR للبلد أو المنطقة التي يقع فيها العنوان. لا يتم استنتاج ذلك أبدًا، وتقع على عاتق المستخدم مسؤولية التأكّد من صحة القيمة. لمعرفة التفاصيل، يمكنك الاطّلاع على http://cldr.unicode.org/ وhttp://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. مثال: "CH" لسويسرا.

string

اختياريّ. رمز لغة محتوى هذا العنوان BCP-47 (إذا كان معروفًا) وهي غالبًا لغة واجهة المستخدم لنموذج الإدخال أو من المتوقّع أن تتطابق مع إحدى اللغات المستخدمة في العنوان الدولة/المنطقة، أو ما يعادلها صوتيًا. ويمكن أن يؤثر ذلك في التنسيق في بلدان معيّنة، ولكنه ليس ضروريًا لتصحيح البيانات، ولن يؤثر أبدًا في أي عملية تحقّق أو عمليات أخرى غير متعلّقة بالتنسيق.

وإذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة).

أمثلة: "zh-Hant" و"ja" و"ja-Latn" و"en".

string

اختياريّ. الرمز البريدي للعنوان. لا تستخدِم بعض البلدان الرموز البريدية أو تشترط توفّر هذه الرموز، ولكن عند استخدامها، قد تُجري عمليات تحقُّق إضافية من خلال أجزاء أخرى من العنوان (مثل التحقّق من صحة الولاية أو الرمز البريدي في الولايات المتحدة الأمريكية).

string

اختياريّ. رمز ترتيب إضافي خاص بالبلد. لا تُستخدم هذه الميزة في معظم المناطق. عند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة بشكل اختياري برقم (مثل "CEDEX 7")، أو مجرد رقم وحده، يمثّل "رمز القطاع" (جامايكا)، "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (على سبيل المثال: ساحل العاج).

string

اختياريّ. أعلى تقسيم فرعي إداري يتم استخدامه للعناوين البريدية لبلد أو منطقة. على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. على وجه التحديد، بالنسبة إلى إسبانيا، هذه هي الإقليم وليس المجتمع المستقلّ (على سبيل المثال، "برشلونة" وليس "كاتالونيا"). لا يستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. مثلاً: في سويسرا يجب عدم تعبئة هذا الحقل.

string

اختياريّ. يشير بوجه عام إلى الجزء من المدينة أو البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، بلدة بريد المملكة المتحدة. في مناطق العالم التي لم يتم فيها تحديد المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل جيدًا، اترك المنطقة المحلية فارغة واستخدم addressLines.

string

اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن تكون الأحياء أو المناطق الإدارية أو المناطق.

string

أسطر عنوان غير منظمة تصف المستويات الأدنى من العنوان.

بما أنّ القيم في addressLines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "أبو ظبي، تكساس")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب أسطر العنوان "ترتيب على شكل مغلف". للبلد أو المنطقة التي يقع فيها العنوان. وفي الأماكن التي قد يختلف فيها الاسم (مثل اليابان)، يتم استخدام address_language لجعله صريحًا (على سبيل المثال، "ja" لترتيب الحروف الكبيرة إلى الصغيرة وja-Latn أو "en" للصغير إلى الكبير). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا للعنوان بناءً على اللغة.

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

إنشاء عنوان يحتوي فقط على رمز المنطقة وسطر العنوان، ومن ثمَّ يُعتبر الترميز الجغرافي الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية).

string

اختياريّ. المستلم على العنوان. في حالات معيّنة، قد يحتوي هذا الحقل على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على كلمة "رعاية" المعلومات.

string

اختياريّ. تمثّل هذه السمة اسم المؤسسة في العنوان.

{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}

object (LineItem)

قائمة عناصر الطلب ويجب توفير عنصر واحد على الأقل، ويُسمح باستخدام 50 عنصرًا كحد أقصى. يجب أن تنتمي كل العناصر إلى موضع الإعلان نفسه.

{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}

string

مطلوب: المعرّف الذي خصّصه التاجر للعنصر. تُستخدَم لتحديد تفاصيل الإعلان الحالية عند تطبيق التعديلات الجزئية. الحد الأقصى المسموح به للطول هو 64 حرفًا.

string

اسم البند كما هو معروض في الإيصال. الحد الأقصى المسموح به للطول هو 100 حرف.

string

تمّ الإيقاف. يُرجى استخدام الحالة العمودية بدلاً من ذلك. على سبيل المثال، بالنسبة إلى عمليات الشراء، استخدِم PurchaseOrderExtension.status. تصنيف مرئي للمستخدم لحالة هذا العنصر

object (Merchant)

تمثّل هذه السمة موفِّر العنصر المعيّن، إذا كان مختلفًا عن الطلب العام. مثال: طلب Expedia مع مقدم خدمة العناصر ANA

object (PriceAttribute)

السعر والتعديلات على مستوى العنصر:

object (Action)

إجراءات المتابعة على تفاصيل الإعلان

object (UserInfo)

بالنسبة إلى العملاء على مستوى العنصر، قد يختلف هذا الخيار عن المشتري على مستوى الطلب. مثال: قام المستخدم س بحجز مطعم تحت اسم المستخدم ص.

object (Image)

صورة صغيرة مرتبطة بهذه السلعة، إن توفّرت

string

وصف البند.

string

ملاحظات إضافية تنطبق على هذا العنصر بالتحديد، مثل سياسة الإلغاء

object (Disclosure)

بيانات الإفصاح المرتبطة بهذا البند

object

متوقّفة نهائيًا: استخدِم الفئات بدلاً منها. المطلوب: المحتوى الدلالي للعنصر استنادًا إلى نوعه أو مجاله. يجب أن يتضمّن كل مجال تفاصيل توصيل الطلب الخاصة به. يجب أن تكون إحدى القيمتين التاليتين: google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

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

object (PurchaseItemExtension)

طلبات الشراء، مثل السلع والطعام وغير ذلك

object (ReservationItemExtension)

طلبات الحجز، مثل المطعم وقص الشعر وما إلى ذلك

{
  "type": enum (Type),
  "name": string,
  "id": string,
  "state": enum (State),
  "taxIncluded": boolean,

  // Union field spec can be only one of the following:
  "amount": {
    object (Money)
  },
  "amountMillipercentage": integer
  // End of list of possible types for union field spec.
}

enum (Type)

مطلوبة: نوع سمة الأموال

string

مطلوبة: يعرض المستخدم سلسلة لسمة السعر. يرسل التاجر هذه المعلومات وترجمتها.

string

اختياري: معرّف العنصر الذي يتوافق معه هذا السعر.

enum (State)

مطلوب: حالة السعر: التقدير مقابل الفعلي.

boolean

تُستخدَم لتحديد ما إذا كان السعر يشمل الضريبة.

object (Money)

المبلغ النقدي.

integer

مواصفات النسبة المئوية، حتى 1/1000 من النسبة المئوية على سبيل المثال: يتم تمثيل 8.750% على شكل 8, 750، وتمثّل النسب المئوية السالبة خصومات بنسبة مئوية. جارٍ إيقاف هذا الحقل نهائيًا. يمكنك إعادة إضافتها عندما تكون هناك حالة استخدام قوية مطلوبة.

{
  "currencyCode": string,
  "amountInMicros": string
}

string

تمثّل هذه السمة رمز العملة المكوَّن من 3 أحرف والمحدّد في ISO 4217.

string (int64 format)

المبلغ بوحدات المايكرو. على سبيل المثال، يجب ضبط هذا الحقل على 1990000 مقابل 1.99 دولار أمريكي.

{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}

enum (Type)

مطلوب: نوع الإجراء

string

عنوان الإجراء أو تصنيفه المعروضَين للمستخدم الحد الأقصى المسموح به للطول هو 100 حرف.

object (OpenUrlAction)

الإجراء الواجب اتخاذه.

object (ActionMetadata)

البيانات الوصفية المرتبطة بإجراء ما.

{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}

string

حقل عنوان URL الذي يمكن أن يكون أيًا مما يلي: - http/https عناوين URL لفتح تطبيق مرتبط بتطبيق أو صفحة ويب

object (AndroidApp)

معلومات حول تطبيق Android إذا كان من المتوقع أن يتم توفير عنوان URL من خلال تطبيق Android.

enum (UrlTypeHint)

يشير هذا الحقل إلى تلميح لنوع عنوان URL.

{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}

string

يجب تحديد اسم الحزمة عند تحديد Android Fulfillment.

object (VersionFilter)

عند تحديد فلاتر متعددة، سيؤدي أي فلتر مطابق إلى تشغيل التطبيق.

{
  "minVersion": integer,
  "maxVersion": integer
}

integer

الحد الأدنى لرمز الإصدار أو 0، بشكل شامل.

integer

الحد الأقصى لرمز الإصدار، شاملة. ويكون النطاق المذكور هو [minVersion:maxVersion]. يتضمن النطاق الفارغ أي إصدار. أمثلة: لتحديد إصدار واحد، استخدِم: [target_version:target_version]. لتحديد أي إصدار، اترك minVersion وmaxVersion بدون تحديد. لتحديد جميع الإصدارات حتى maxVersion، اترك minVersion غير محدَّد. لتحديد جميع الإصدارات من minVersion، اترك maxVersion غير محدّد.

{
  "expireTime": string
}

string (Timestamp format)

الوقت الذي ستنتهي فيه صلاحية هذا الإجراء

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}

string

عنوان الإفصاح مثال: "معلومات الأمان".

object (DisclosureText)

محتوى الإفصاح روابط الويب مسموح بها.

object (DisclosurePresentationOptions)

خيارات العرض التقديمي لبيان الإفصاح

{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}

string

النص المطلوب عرضه، يحتوي على عناصر نائبة مثل "{0}" و "{1}" لكل رابط نصي يجب إدراجه. مثال: "تحذير: يمكن أن يعرّضك هذا المنتج لمواد كيميائية معروفة في ولاية كاليفورنيا أنّها تسبب السرطان. لمزيد من المعلومات، انتقل إلى {0}." يجب ألا يحتوي نص الإفصاح عن جهة تمويل الإعلان على أي محتوى ترويجي أو مشابه للإعلانات.

object (TextLink)

هي الروابط النصية التي يجب استبدالها في النموذج. سيتم استبدال أول عنوان بـ "{0}" في سلسلة النموذج، والخيار الثاني لـ "{1}"، وما إلى ذلك.

{
  "displayText": string,
  "url": string
}

string

النص الذي يجب عرضه للمستخدمين

string

عنوان URL الذي يجب توجيه المستخدمين إليه عند تفعيل الرابط.

{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}

enum (PresentationRequirement)

متطلبات عرض بيان الإفصاح:

boolean

ما إذا كان يجب توسيع محتوى بيان الإفصاح في البداية ويتم تصغيرها في البداية بشكل تلقائي.

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "productDetails": {
    object (ProductDetails)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (PurchaseStatus)

مطلوب: الحالة على مستوى العنصر

string

المطلوب: إظهار التصنيف/سلسلة للمستخدم لمعرفة الحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا.

enum (PurchaseType)

مطلوب: نوع عملية الشراء

string

معرّف المنتج أو العرض المرتبط بهذا العنصر

integer

كمية السلعة

object (MerchantUnitMeasure)

قياس الوحدة. تُستخدَم لتحديد حجم السلعة في الوحدات المختارة. يتم استخدام الحجم مع السعر النشط لتحديد سعر الوحدة.

object (PurchaseReturnsInfo)

تؤدي إلى إرجاع معلومات لهذا العنصر. في حال ترك هذه السياسة بدون ضبط، سيكتسب هذا العنصر معلومات إرجاع مستوى الطلب.

object (PurchaseFulfillmentInfo)

معلومات التنفيذ لهذا العنصر وفي حال ترك هذه السياسة بدون ضبط، سيكتسب هذا العنصر معلومات التنفيذ على مستوى الطلب.

object (ItemOption)

إضافات أو عناصر فرعية إضافية

object (ProductDetails)

تمثّل هذه السمة تفاصيل حول المنتج.

object

أي حقول إضافية يتم تبادلها بين التاجر وGoogle ملاحظة: لا يُنصح باستخدام هذه الإضافة. بناءً على حالة الاستخدام أو الظروف، يجب مراعاة أي مما يلي: 1. حدِّد الحقول في purchaseItemExtension إذا كان من الممكن استخدامها لحالات استخدام أخرى (مثل الإمكانات/الوظائف العامة). 2. ويمكنك استخدام vertical_extension إذا كانت خاصة بحالة استخدام أو ميزة مخصّصة غير عامة.

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

{
  "measure": number,
  "unit": enum (Unit)
}

number

القيمة: مثال 1.2.

enum (Unit)

الوحدة: مثال على POUND، GRAM.

{
  "isReturnable": boolean,
  "daysToReturn": integer,
  "policyUrl": string
}

boolean

إذا كانت القيمة true، يُسمح بالإرجاع.

integer

يُسمح بإرجاع السلع خلال هذه الأيام العديدة.

string

الرابط الذي يؤدي إلى سياسة الإرجاع

{
  "id": string,
  "fulfillmentType": enum (Type),
  "expectedFulfillmentTime": {
    object (Time)
  },
  "expectedPreparationTime": {
    object (Time)
  },
  "location": {
    object (Location)
  },
  "expireTime": string,
  "price": {
    object (PriceAttribute)
  },
  "fulfillmentContact": {
    object (UserInfo)
  },
  "shippingMethodName": string,
  "storeCode": string,
  "pickupInfo": {
    object (PickupInfo)
  }
}

string

معرّف فريد لخيار الخدمة هذا

enum (Type)

مطلوب: نوع توصيل الطلب.

object (Time)

الإطار عند تحديد نطاق زمني أو الوقت المقدر للوصول إذا تم تحديد وقت واحد. الوقت المتوقَّع للتسليم أو الاستلام.

object (Time)

الإطار عند تحديد نطاق زمني أو الوقت المقدر للوصول إذا تم تحديد وقت واحد. الوقت المتوقع لإعداد الطعام. ويفضَّل أن يتم العرض مرة واحدة.

object (Location)

الموقع الجغرافي لاستلام الطلب أو التسليم.

string (Timestamp format)

الوقت الذي تنتهي فيه صلاحية خيار توصيل الطلب هذا

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

object (PriceAttribute)

تكلفة هذا الخيار.

object (UserInfo)

معلومات اتصال المستخدم الخاصة بعملية التنفيذ هذه

string

اسم طريقة الشحن التي اختارها المستخدم

string

رمز المتجر للموقع الجغرافي مثال: Walmart هو التاجر، وstoreCode هو متجر walmart الذي تم توصيل الطلب منه. https://support.google.com/business/answer/3370250?ref_topic=4596653.

object (PickupInfo)

معلومات إضافية حول كيفية اختيار الطلب. لن يكون هذا الحقل ساريًا إلا عندما يكون نوع التنفيذ هو PICKUP.

{
  "timeIso8601": string
}

string

يمثّل وقت حدث الطلب، مثل وقت الحجز ووقت التسليم وما إلى ذلك. يمكن أن يتمثل في مدة (وقت البدء والانتهاء) أو التاريخ أو الوقت أو ما إلى ذلك. يُرجى الرجوع إلى https://en.wikipedia.org/wiki/ISO_8601 للاطّلاع على جميع التنسيقات المتوافقة.

{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}

enum (PickupType)

طريقة الاستلام، مثل INSTORE وCURBSIDE وما إلى ذلك

object (CurbsideInfo)

تفاصيل خاصة بمعلومات الرصيف. إذا لم يكن pickupType ليس "CURBSIDE"، سيتم تجاهل هذا الحقل.

object (CheckInInfo)

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

{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}

enum (CurbsideFulfillmentType)

يحتاج الشركاء إلى معلومات إضافية لتسهيل طلبات الاستلام من السيارة. وبناءً على نوع توصيل الطلب الذي يتم اختياره، سيتم جمع التفاصيل المقابلة من المستخدم.

object (Vehicle)

تفاصيل المركبة الخاصة بالمستخدم الذي قدّم الطلب

{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}

string

العلامة التجارية للمركبة (مثل "هوندا"). يتم عرض هذه المعلومات للمستخدم ويجب ترجمتها. مطلوب.

string

طراز المركبة (مثل "الغروم"). يتم عرض هذه المعلومات للمستخدم ويجب ترجمتها. مطلوب.

string

رقم لوحة ترخيص المركبة (مثل "1ABC234") مطلوب.

string

اسم لون المركبة، مثل الأسود اختياري.

object (Image)

عنوان URL لصورة المركبة سيتم عرض الصورة بحجم 256×256 بكسل تقريبًا. يجب أن تكون بتنسيق jpg أو png. اختياريّ.

{
  "checkInType": enum (CheckInType)
}

enum (CheckInType)

الطريقة المستخدمة لإرسال تعليمات تسجيل الوصول.

{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}

string

بالنسبة إلى خيارات السلع، معرّف السلعة الفريد

string

اسم الخيار.

object (PriceAttribute)

السعر الإجمالي للخيار

string

ملاحظة ذات صلة بالخيار

integer

بالنسبة إلى خيارات السلع والكمية.

string

معرّف المنتج أو العرض المرتبط بهذا الخيار

object (ItemOption)

لتحديد خيارات فرعية متداخلة أخرى.

{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}

string

معرّف المنتج أو العرض المرتبط بهذا العنصر

string

تمثّل هذه السمة الرقم التجاري العالمي للسلعة للمنتج. ويكون هذا الخيار مفيدًا في حال عدم توفّر معرّف العرض في Merchant Center. اختياريّ.

string

إنّ رموز البحث عن الأسعار، المعروفة عادةً برموز PLU أو أرقام PLU أو أرقام PLU أو رموز الإنتاج أو تصنيفات المنتجات، هي منظومة من الأرقام التي تحدّد بشكل فريد المنتجات المجمّعة التي يتم بيعها في متاجر البقالة ومحلات السوبرماركت.

string

فئة المنتج التي حدّدها التاجر. مثلاً: الصفحة الرئيسية > بقالة > منتجات الألبان البيض > حليب > حليب كامل الدسم"

map (key: string, value: string)

التفاصيل التي يقدّمها التاجر عن المنتج، مثل: { "allergen": "peanut" }. ويكون هذا الخيار مفيدًا في حال عدم توفّر معرّف العرض في Merchant Center. اختياريّ.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  }
}

enum (ReservationStatus)

مطلوب: حالة الحجز.

string

المطلوب: إظهار التصنيف/سلسلة للمستخدم لمعرفة الحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا.

enum (ReservationType)

نوع الحجز. ويمكن إلغاء التعيين في حال عدم انطباق أي من خيارات النوع.

object (Time)

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

object (Time)

النطاق الزمني المقبول للمستخدم

string

رمز تأكيد هذا الحجز.

integer

عدد الأشخاص.

object (StaffFacilitator)

منسّقو الموظفين الذين سيقدمون خدمة الحجز. مثال مصفّف الشعر.

object (Location)

الموقع الجغرافي للخدمة/الحدث.

{
  "name": string,
  "image": {
    object (Image)
  }
}

string

تمثّل هذه السمة اسم المُنسّق. مثال "جون سميث"

object (Image)

صور مؤدي الأداء

{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}

object (PaymentResult)

نتيجة الدفع التي تستخدمها شركة الدمج لإكمال معاملة ستتم تعبئة هذا الحقل بواسطة "المهام مع مساعد Google" إذا كانت تجربة الدفع مُدارة من خلال "المهام مع مساعد Google".

object (PaymentInfo)

معلومات الدفع المتعلقة بالطلب، والذي يكون مفيدًا للتفاعل الموجّه للمستخدمين

{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}

string

قدّمت Google بيانات طريقة الدفع. إذا كانت الجهة المسؤولة عن معالجة المعاملات مدرَجة كجهة معالجة دفعات معتمَدة من Google على هذا الرابط: https://developers.google.com/pay/api/، انتقِل إلى الجهة المسؤولة عن معالجة المعاملات من خلال الرابط للحصول على مزيد من التفاصيل. في الحالات الأخرى، يمكنك الاطّلاع على المستندات التالية للحصول على تفاصيل الحمولة. https://developers.google.com/pay/api/payment-data-cryptography

string

طريقة الدفع المقدّمة من التاجر/الإجراء والتي اختارها المستخدم

{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}

object (PaymentMethodDisplayInfo)

المعلومات المعروضة حول طريقة الدفع المُستخدَمة في المعاملة

enum (PaymentMethodProvenance)

مصدر طريقة الدفع المُستخدَمة في المعاملة من المحتمل أن يكون المستخدم قد سجَّل طريقة الدفع نفسها لدى كل من Google والتاجر.

{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}

enum (PaymentType)

تمثّل هذه السمة نوع الدفعة.

string

الاسم المرئي لطريقة الدفع على سبيل المثال، VISA **** 1234 Checkout acct **** 5678

string

اسم طريقة الدفع الذي سيتم قوله للمستخدم على الأجهزة المزوّدة بخدمة "مساعد Google" بالصوت فقط مَثَلًا، "التأشيرة المنتهية بـ واحد اثنان ثلاثة أربعة" أو "الحساب الجاري ينتهي بخمسة ثمانية وثمانين". ملاحظة: هذه هي السلسلة المحسّنة للصوت التي سيتم استخدامها بدلاً من paymentMethodDisplayName للأجهزة المزوّدة بخدمة "مساعد Google" بالصوت فقط. في حال عدم ضبط هذه السلسلة، سيتم نطق paymentMethodDisplayName إلى المستخدم بدلاً من ذلك.

{
  "coupon": string
}

string

مطلوب: رمز القسيمة المطبَّق على هذا العرض.

{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (PurchaseStatus)

مطلوب: الحالة العامة للطلب

string

إظهار المستخدم للتصنيف/السلسلة للحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا.

enum (PurchaseType)

مطلوب: نوع عملية الشراء

object (PurchaseReturnsInfo)

إرجاع معلومات الطلب

object (PurchaseFulfillmentInfo)

معلومات توصيل الطلب الخاصة بالطلب

enum (PurchaseLocationType)

موقع عملية الشراء (في المتجر / على الإنترنت)

object (PurchaseError)

اختياري: الأخطاء التي أدّت إلى رفض هذا الطلب.

object

أي حقول إضافية يتم تبادلها بين التاجر وGoogle ملاحظة: لا يُنصح باستخدام هذه الإضافة. بناءً على حالة الاستخدام أو الظروف، يجب مراعاة أي مما يلي: 1. حدِّد الحقول في purchaseOrderExtension إذا كان من الممكن استخدامها لحالات استخدام أخرى (مثل الإمكانات/الوظائف العامة). 2. ويمكنك استخدام vertical_extension إذا كانت خاصة بحالة استخدام أو ميزة مخصّصة غير عامة.

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

{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}

enum (ErrorType)

مطلوب: يمثّل هذا الحقل السبب الدقيق لرفض التاجر للطلب.

string

وصف إضافي للخطأ.

string

رقم تعريف الكيان الذي يتوافق مع الخطأ. مثال: يمكن أن تتوافق هذه القيمة مع LineItemId / ItemOptionId.

object (PriceAttribute)

هذه السمة مفيدة في حال نوع الخطأ PRICE_CHANGED / INCORRECT_PRICE.

integer

الكمية متوفرة الآن. سارٍ في حال AVAILABILITY_CHANGED.

{
  "ticketEvent": {
    object (TicketEvent)
  }
}

object (TicketEvent)

تم تطبيق الحدث على جميع تذاكر تفاصيل الإعلان.

{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}

enum (Type)

مطلوب: نوع حدث التذكرة، على سبيل المثال أو فيلم أو حفلة موسيقية.

string

مطلوب: اسم الفعالية. على سبيل المثال، إذا كان الحدث عبارة عن فيلم، يجب أن يكون هذا اسم الفيلم.

string

تمثّل هذه السمة وصف الفعالية.

string

عنوان URL لمعلومات الفعالية.

object (Location)

تمثّل هذه السمة الموقع الجغرافي الذي ستقام فيه الفعالية أو المؤسسة.

object (EventCharacter)

تمثّل هذه السمة الشخصيات ذات الصلة بهذا الحدث. يمكن أن يكونوا مخرجين أو ممثلين لحدث فيلم، أو مقدمو حفلة موسيقية، وما إلى ذلك.

object (Time)

وقت البدء

object (Time)

وقت الانتهاء

object (Time)

وقت الإدخال، الذي قد يختلف عن وقت بدء الحدث مثلاً: يبدأ الحدث في الساعة 9 صباحًا، ولكن وقت الدخول هو 8:30 صباحًا.

{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}

enum (Type)

نوع حرف الحدث، على سبيل المثال ممثل أو مخرج.

string

تمثّل هذه السمة اسم الشخصية.

object (Image)

صور الشخصية.

{
  "title": string,
  "text": string
}

string

تمثّل هذه السمة عنوان إشعار المستخدم. الحد الأقصى المسموح به للطول هو 30 حرفًا.

string

محتوى الإشعار. الحد الأقصى المسموح به للطول هو 100 حرف.

{
  "name": string
}

string

اسم المشهد المطلوب تنفيذه بعد ذلك

{
  "id": string,
  "params": {
    string: value,
    ...
  },
  "typeOverrides": [
    {
      object (TypeOverride)
    }
  ],
  "languageCode": string
}

string

مطلوب. معرّف فريد عالمي لجلسة المحادثة الحالية. هذا الحقل للقراءة فقط.

map (key: string, value: value (Value format))

مطلوب. قائمة بجميع المَعلمات التي يتم جمعها من النماذج والأهداف أثناء الجلسة المفتاح هو اسم المَعلمة. سيتم دمج المعلّمات المحدّدة هنا مع المَعلمات التي سبق أن تم تحديدها في الجلسة. وستتمّ إزالة المَعلمات ذات القيمة الفارغة من الجلسة. يمكنك الاطّلاع على مستندات مساحة تخزين الجلسة: https://developers.google.com/assistant/conversational/storage-session.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

object (TypeOverride)

اختياريّ. الأنواع المحدّدة في الجلسة. يمكن أن تكمل تحديدات نوع الجلسة الأنواع الحالية أو تحل محلها. يجب أن تكون أسماء الأنواع فريدة.

string

لغة جلسة المحادثة الحالية يتّبع رمز اللغة IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt. قد يختلف هذا الإعداد عن لغة المستخدم إذا كان الإجراء يستخدم ميزات لغات متعددة. على سبيل المثال، عندما يتم ضبط handler_response.required.language_code، يتمّ تغيير لغة المحادثة لجميع الأدوار التالية، وهو ما سينعكس في هذا الحقل.

{
  "name": string,
  "mode": enum (TypeOverrideMode),
  "synonym": {
    object (SynonymType)
  }
}

string

مطلوب. اسم النوع الذي يمكن استكماله أو إلغائه.

enum (TypeOverrideMode)

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

object (SynonymType)

{
  "entries": [
    {
      object (Entry)
    }
  ]
}

object (Entry)

مطلوب. قائمة إدخالات لنوع المرادف.

{
  "name": string,
  "synonyms": [
    string
  ],
  "display": {
    object (EntryDisplay)
  }
}