Order

{
  "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": number,
  "width": number
}

string

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

string

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

number

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

number

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

{
  "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": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

number

تمثّل هذه السمة مراجعة المخطط لـ 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)

قائمة عناصر الطلب يجب توفّر عنصر line_item واحد على الأقل، ويُسمح بـ 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,
  "state": enum (State),
  "taxIncluded": boolean,

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

enum (Type)

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

string

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

enum (State)

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

boolean

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

object (Money)

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

number

مواصفات النسبة المئوية، حتى 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": number,
  "maxVersion": number
}

number

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

number

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

{
  "expireTime": string
}

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "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": number,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}

enum (PurchaseStatus)

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

string

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

enum (PurchaseType)

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

string

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

number

كمية السلعة

object (MerchantUnitMeasure)

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

object (PurchaseReturnsInfo)

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

object (PurchaseFulfillmentInfo)

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

object (ItemOption)

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

object

أي حقول إضافية يتم تبادلها بين التاجر وGoogle

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

object (ProductDetails)

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

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

number

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

enum (Unit)

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

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

boolean

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

number

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

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: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": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}

string

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

string

اسم الخيار.

object (PriceAttribute)

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

string

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

number

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

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": number,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}

enum (ReservationStatus)

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

string

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

enum (ReservationType)

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

object (Time)

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

object (Time)

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

string

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

number

عدد الأشخاص.

object (StaffFacilitator)

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

object (Location)

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

object

أي حقول إضافية يتم تبادلها بين التاجر وGoogle

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

{
  "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)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}

enum (PurchaseStatus)

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

string

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

enum (PurchaseType)

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

object (PurchaseReturnsInfo)

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

object (PurchaseFulfillmentInfo)

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

object

أي حقول إضافية يتم تبادلها بين التاجر وGoogle

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

enum (PurchaseLocationType)

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

object (PurchaseError)

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

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

enum (ErrorType)

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

string

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

string

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

object (PriceAttribute)

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

number

الكمية متوفرة الآن. سارٍ في حال 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)

صور الشخصية.