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

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

object (Simple)

اختياريّ. الاستجابة الأولى للصوت والنص فقط.

object (Content)

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

object (Simple)

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

object (Suggestion)

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

object (Link)

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

object (Canvas)

اختياريّ. تُمثِّل استجابة "لوحة الرسم التفاعلية" التي سيتم إرسالها إلى المستخدم.

object (OrderUpdate)

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

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

string

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

string

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

{

  // 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

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

object (Image)

صورة رئيسية للبطاقة. تم تثبيت الارتفاع على 192dp. اختياريّ.

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)

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

object (Link)

زرّ

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

string

نص رأس العمود.

enum (HorizontalAlignment)

المحاذاة الأفقية لعمود المحتوى. إذا لم يتم تحديده، فستتم محاذاة المحتوى إلى الحافة الأمامية.

{
  "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)

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

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)

مطلوبة. يفتح معرّف الموارد المنتظم إذا تم تحديد العنصر.

{
  "title": string
}

string

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

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

string

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

value (Value format)

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

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 إلا مع تحديثات حالة PurcahaseOrderExtension ولا توجد خطة لتمديد هذا الدعم. بدلاً من ذلك، ننصحك باستخدام 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 المُقدّم أو على أي قيمة فريدة أخرى. تجدر الإشارة إلى أن المعرّف المقدّم للمستخدمين هو userUserOrderId، والذي قد يكون قيمة مختلفة وسهلة الاستخدام. الحد الأقصى للطول المسموح به هو 128 حرفًا.

string

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

string

مهمل: استخدم حالة OrderExtensions بدلاً من ذلك. تصنيف مرئي للمستخدم لحالة هذا الطلب.

object (UserInfo)

معلومات حول المشتري.

object (Image)

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

string (Timestamp format)

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

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu"، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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، كما تم تعريفه في الاتحاد الدولي للاتصالات (ITU)، مقترح E.164. رابط wiki: https://en.wikipedia.org/wiki/E.164

string

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

string

رمز تحديد مشغل شبكة الجوال المفضل عند الاتصال برقم الهاتف هذا محليًا. ويشمل ذلك أيضًا الرموز التي يلزم طلبها في بعض البلدان عند الاتصال من الخطوط الأرضية إلى الهواتف الجوّالة أو العكس. على سبيل المثال، في كولومبيا، يجب طلب الرقم "3" قبل رقم الهاتف نفسه عند الاتصال من هاتف جوّال إلى هاتف أرضي محلي والعكس صحيح. https://en.wikipedia.org/wiki/Phone_numbers_in_كولومبيا 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 مع واجهة برمجة تطبيقات الأماكن لجلب تفاصيل المكان. يُرجى الاطِّلاع على 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" للصغار والكبيرين). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا في العنوان استنادًا إلى اللغة.

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

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

string

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

string

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

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

object (LineItem)

قائمة عناصر الطلب. يلزم وجود عنصر عنصر واحد على الأقل ومسموح بخمسين كحد أقصى. يجب أن تنتمي جميع العناصر إلى قطاع واحد.

{
  "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% على أنها 8750، وتمثل النسب المئوية السلبية خصومات بالنسبة المئوية. جارٍ إيقاف هذا الحقل. يمكنك الإضافة مرة أخرى عند الحاجة إلى حالة استخدام ثابتة.

{
  "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.

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 "Zulu"، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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)

الوحدة: Example 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 "Zulu"، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

object (PriceAttribute)

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

object (UserInfo)

جهة اتصال المستخدم لتنفيذ هذه العملية.

string

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

string

رمز المتجر للموقع. مثال: Walmart هو التاجر ورمز المتجر هو متجر 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" }، ويُعدّ ذلك مفيدًا في حال عدم توفّر promotionId في 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 وMerchant.

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

enum (PaymentType)

نوع الدفعة.

string

الاسم الذي يظهر للمستخدم لطريقة الدفع. على سبيل المثال، VISA **** 1234 جارٍ التحقق من الحساب **** 5678

string

اسم طريقة الدفع لنطقه للمستخدم على الأجهزة المزوّدة بخدمة "مساعد Google" بالصوت فقط. على سبيل المثال: "التأشيرة تنتهي بواحد أو اثنين أو أربعة" أو "جارٍ التحقق من الحساب الذي ينتهي بخمسة وستة وثمانية". ملاحظة: هذه هي السلسلة المحسَّنة للصوت التي سيتم استخدامها بدلاً من paymentMethodDisplayName في الأجهزة المزوّدة بخدمة المساعد الصوتي فقط. وإذا لم يتم ضبط هذه السلسلة، سيتم نطق 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. وقد يختلف هذا عن لغة المستخدم إذا كان الإجراء يستخدم ميزات متعددة اللغات. على سبيل المثال، عند تعيين Wizard_response.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)
  }
}