Order

كيان الطلب: ملاحظة: 1- يجب أن تكون كل السلاسل على جميع المستويات أقل من 1000 حرف ما لم يتم تحديد خلاف ذلك. 2. يجب أن يكون عدد جميع الحقول المتكرّرة على جميع المستويات أقل من 50، ما لم يتم تحديد خلاف ذلك. 3- يجب أن تكون كل الطوابع الزمنية بجميع المستويات، في حال تحديدها، طوابع زمنية صالحة.

تمثيل JSON 
{
  "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.
}
الحقول
googleOrderId

string

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

merchantOrderId

string

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

userVisibleOrderId

string

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

userVisibleStateLabel
(deprecated)

string

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

object (UserInfo)

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

image

object (Image)

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

createTime

string (Timestamp format)

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

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

string (Timestamp format)

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

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

object (Merchant)

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

contents

object (Contents)

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

priceAttributes[]

object (PriceAttribute)

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

followUpActions[]

object (Action)

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

paymentData

object (PaymentData)

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

termsOfServiceUrl

string

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

note

string

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

promotions[]

object (Promotion)

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

disclosures[]

object (Disclosure)

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

vertical
(deprecated)

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" }
حقل الاتحاد verticals. سيتم تطبيق هذه السمات على جميع تفاصيل الإعلانات، ما لم يتم إلغاؤها في بعض تفاصيل الإعلانات. يجب أن يتطابق هذا العمود مع النوع العمودي على مستوى العنصر. يمكن أن يكون verticals واحدًا فقط مما يلي:
purchase

object (PurchaseOrderExtension)

أمر الشراء

ticket

object (TicketOrderExtension)

طلب التذكرة

UserInfo

معلومات حول المستخدم وتُستخدم هذه السمة لتمثيل معلومات المستخدم المرتبط بالطلب.

تمثيل JSON 
{
  "email": string,
  "firstName": string,
  "lastName": string,
  "displayName": string,
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ]
}
الحقول
email

string

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

firstName

string

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

lastName

string

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

displayName

string

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

phoneNumbers[]

object (PhoneNumber)

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

رقم الهاتف

التمثيل العادي لرقم الهاتف

تمثيل JSON 
{
  "e164PhoneNumber": string,
  "extension": string,
  "preferredDomesticCarrierCode": string
}
الحقول
e164PhoneNumber

string

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

extension

string

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

preferredDomesticCarrierCode

string

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

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

صورة

صورة معروضة في البطاقة

تمثيل JSON 
{
  "url": string,
  "accessibilityText": string,
  "height": number,
  "width": number
}
الحقول
url

string

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

accessibilityText

string

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

height

number

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

width

number

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

التاجر

تاجر سلة التسوّق أو الطلب أو العنصر

تمثيل JSON 
{
  "id": string,
  "name": string,
  "image": {
    object (Image)
  },
  "phoneNumbers": [
    {
      object (PhoneNumber)
    }
  ],
  "address": {
    object (Location)
  }
}
الحقول
id

string

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

name

string

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

image

object (Image)

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

phoneNumbers[]

object (PhoneNumber)

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

address

object (Location)

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

الموقع الجغرافي

حاوية تمثّل موقعًا جغرافيًا

تمثيل JSON 
{
  "coordinates": {
    object (LatLng)
  },
  "formattedAddress": string,
  "zipCode": string,
  "city": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "name": string,
  "phoneNumber": string,
  "notes": string,
  "placeId": string
}
الحقول
coordinates

object (LatLng)

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

string

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

string

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

string

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

object (PostalAddress)

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

string

اسم المكان.

phoneNumber

string

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

notes

string

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

placeId

string

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

LatLng

كائن يمثّل زوجًا من خط العرض/الطول. ويتم التعبير عنها في صورة زوج من الزوجين يمثلان درجات وخط الطول وخط العرض. ويجب أن يتوافق مع معيار WGS84 ما لم يُذكر خلاف ذلك. يجب أن تكون القيم ضمن النطاقات التي تمت تسويتها.

تمثيل JSON 
{
  "latitude": number,
  "longitude": number
}
الحقول
latitude

number

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

longitude

number

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

PostalAddress

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

في الاستخدام النموذجي، يتم إنشاء عنوان من خلال البيانات التي يُدخلها المستخدم أو من استيراد البيانات الحالية، وذلك حسب نوع العملية.

نصائح بشأن إدخال أو تعديل العنوان: - يجب استخدام تطبيق مصغّر مخصّص للعنوان i18n، مثل https://github.com/google/libaddressinput). يجب عدم عرض عناصر واجهة المستخدم في واجهة المستخدم لإدخال أو تعديل الحقول خارج البلدان التي يُستخدَم فيها هذا الحقل.

لمزيد من الإرشادات حول كيفية استخدام هذا المخطط، يُرجى الاطّلاع على: https://support.google.com/business/answer/6397478

تمثيل JSON 
{
  "revision": number,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
الحقول
revision

number

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

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

string

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

languageCode

string

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

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

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

string

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

sortingCode

string

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

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

string

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

organization

string

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

المحتويات

ملف تغليف العناصر

تمثيل JSON 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
الحقول
lineItems[]

object (LineItem)

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

LineItem

يحتوي بند واحد على عمود واحد. يمكن أن يحتوي الطلب أو سلة التسوق على عناصر متعددة من نفس موضع الإعلان. يجب تحديد العناصر الفرعية/الإضافات وما إلى ذلك في نماذج أوّلية رأسية بناءً على حالات استخدامها. ملاحظة: 1- يجب أن تكون كل السلاسل على جميع المستويات أقل من 1000 حرف ما لم يتم تحديد خلاف ذلك. 2. يجب أن يكون عدد جميع الحقول المتكرّرة على جميع المستويات أقل من 50، ما لم يتم تحديد خلاف ذلك. 3- يجب أن تكون كل الطوابع الزمنية بجميع المستويات، في حال تحديدها، طوابع زمنية صالحة.

تمثيل JSON 
{
  "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.
}
الحقول
id

string

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

name

string

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

userVisibleStateLabel
(deprecated)

string

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

object (Merchant)

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

priceAttributes[]

object (PriceAttribute)

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

followUpActions[]

object (Action)

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

recipients[]

object (UserInfo)

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

image

object (Image)

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

description

string

وصف البند.

notes[]

string

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

disclosures[]

object (Disclosure)

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

vertical
(deprecated)

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" }
حقل الاتحاد verticals. المطلوب: المحتوى الدلالي للعنصر استنادًا إلى نوعه أو مجاله. يجب أن يتضمّن كل مجال تفاصيل توصيل الطلب الخاصة به. يمكن أن يكون verticals واحدًا فقط مما يلي:
purchase

object (PurchaseItemExtension)

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

reservation

object (ReservationItemExtension)

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

PriceAttribute

سمة السعر لطلب أو عنصر

تمثيل JSON 
{
  "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.
}
الحقول
type

enum (Type)

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

name

string

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

state

enum (State)

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

taxIncluded

boolean

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

حقل الاتحاد spec. تُمثِّل المبلغ النقدي أو النسبة المئوية بالمللي ثانية. يمكن أن يكون spec واحدًا فقط مما يلي:
amount

object (Money)

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

amountMillipercentage
(deprecated)

number

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

النوع

يمثل نوع المال.

عمليات التعداد
TYPE_UNSPECIFIED لم يتم تحديد النوع، ويجب ألا يحتاج العملاء إلى ضبطه بشكلٍ صريح.
REGULAR السعر المعروض العادي، قبل تطبيق أي خصومات وغير ذلك
DISCOUNT يجب طرحها من الإجمالي الفرعي.
TAX ستتم إضافته إلى الإجمالي الفرعي.
DELIVERY ستتم إضافته إلى الإجمالي الفرعي.
SUBTOTAL قد يكون المبلغ الإجمالي الفرعي قبل إضافة بعض الرسوم.
FEE أي رسوم إضافية
GRATUITY ستتم إضافته إلى الإجمالي الفرعي.
TOTAL السعر المعروض للطلب أو العنصر.

الحالة

يمثّل هذا الحقل ولاية السعر.

عمليات التعداد
STATE_UNSPECIFIED لم يتم تحديده.
ESTIMATE يُعد السعر مجرد تقدير.
ACTUAL السعر الفعلي الذي سيتم تحصيله للمستخدم.

المال

يمثل مبلغًا من المال مع نوع العملة.

تمثيل JSON 
{
  "currencyCode": string,
  "amountInMicros": string
}
الحقول
currencyCode

string

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

amountInMicros

string (int64 format)

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

الإجراء

إجراء متابعة مرتبط بالطلب أو العنصر

تمثيل JSON 
{
  "type": enum (Type),
  "title": string,
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "actionMetadata": {
    object (ActionMetadata)
  }
}
الحقول
type

enum (Type)

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

title

string

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

openUrlAction

object (OpenUrlAction)

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

actionMetadata

object (ActionMetadata)

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

النوع

إجراءات المتابعة المحتملة.

عمليات التعداد
TYPE_UNSPECIFIED إجراء غير محدَّد.
VIEW_DETAILS عرض إجراء تفاصيل الطلب
MODIFY تعديل إجراء الطلب
CANCEL إلغاء إجراء الطلب
RETURN إجراء طلب الإرجاع.
EXCHANGE إجراء طلب Exchange.
EMAIL

إجراء البريد الإلكتروني. تم إيقاف نوعَي EMAIL وCALL نهائيًا. يمكن استخدام openUrlAction.url كرقم هاتف أو بريد إلكتروني.
CALL

إجراء المكالمة
REORDER إعادة ترتيب الإجراء.
REVIEW مراجعة إجراء الطلب
CUSTOMER_SERVICE يُرجى التواصل مع خدمة العملاء.
FIX_ISSUE يجب الانتقال إلى الموقع الإلكتروني أو التطبيق الخاص بالتاجر لحلّ المشكلة.
DIRECTION رابط الاتجاه

OpenUrlAction

لفتح عنوان URL المحدّد.

تمثيل JSON 
{
  "url": string,
  "androidApp": {
    object (AndroidApp)
  },
  "urlTypeHint": enum (UrlTypeHint)
}
الحقول
url

string

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

androidApp

object (AndroidApp)

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

urlTypeHint

enum (UrlTypeHint)

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

AndroidApp

مواصفات تطبيق Android في ما يتعلّق بقيود التنفيذ

تمثيل JSON 
{
  "packageName": string,
  "versions": [
    {
      object (VersionFilter)
    }
  ]
}
الحقول
packageName

string

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

versions[]

object (VersionFilter)

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

VersionFilter

يجب تضمين VersionFilter إذا كانت هناك إصدارات معيّنة من التطبيق مطلوبة.

تمثيل JSON 
{
  "minVersion": number,
  "maxVersion": number
}
الحقول
minVersion

number

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

maxVersion

number

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

UrlTypeHint

الأنواع المختلفة من تلميحات عناوين URL:

عمليات التعداد
URL_TYPE_HINT_UNSPECIFIED غير محدّد
AMP_CONTENT يشير عنوان URL مباشرةً إلى محتوى AMP أو إلى عنوان URL أساسي يشير إلى محتوى AMP من خلال <link rel="amphtml">.

ActionMetadata

البيانات الوصفية ذات الصلة لكل إجراء

تمثيل JSON 
{
  "expireTime": string
}
الحقول
expireTime

string (Timestamp format)

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

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

الإفصاح

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

تمثيل JSON 
{
  "title": string,
  "disclosureText": {
    object (DisclosureText)
  },
  "presentationOptions": {
    object (DisclosurePresentationOptions)
  }
}
الحقول
title

string

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

disclosureText

object (DisclosureText)

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

presentationOptions

object (DisclosurePresentationOptions)

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

DisclosureText

يمثل نصًا عاديًا مع روابط ويب.

تمثيل JSON 
{
  "template": string,
  "textLinks": [
    {
      object (TextLink)
    }
  ]
}
الحقول
template

string

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

DisclosurePresentationOptions

الخيارات المتاحة لعرض بيان الإفصاح.

تمثيل JSON 
{
  "presentationRequirement": enum (PresentationRequirement),
  "initiallyExpanded": boolean
}
الحقول
presentationRequirement

enum (PresentationRequirement)

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

initiallyExpanded

boolean

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

PresentationRequirement

مطلب عرض الإفصاح.

عمليات التعداد
REQUIREMENT_UNSPECIFIED مطلب غير محدَّد ويجب عدم ضبط هذه الإعدادات بشكل صريح.
REQUIREMENT_OPTIONAL ويكون هذا الإفصاح اختياريًا. ويمكن تخطّيه إذا كان الجهاز لا يتيح عرض الإفصاحات.
REQUIREMENT_REQUIRED يجب تقديم بيان الإفصاح. سيتم إرسال المحادثة إلى الهاتف إذا كان الجهاز لا يتيح عرض الإفصاحات.

PurchaseItemExtension

محتوى العناصر في قطاع الشراء

تمثيل JSON 
{
  "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)
  }
}
الحقول
status

enum (PurchaseStatus)

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

userVisibleStatusLabel

string

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

type

enum (PurchaseType)

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

productId
(deprecated)

string

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

number

كمية السلعة

unitMeasure

object (MerchantUnitMeasure)

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

returnsInfo

object (PurchaseReturnsInfo)

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

fulfillmentInfo

object (PurchaseFulfillmentInfo)

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

itemOptions[]

object (ItemOption)

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

extension

object

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

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

object (ProductDetails)

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

PurchaseStatus

حالة الشراء المرتبطة بطلب الشراء أو بعنصر معيّن

عمليات التعداد
PURCHASE_STATUS_UNSPECIFIED لم يتم تحديد الحالة.
READY_FOR_PICKUP جاهز للاستلام.
SHIPPED تم شحن الطرد.
DELIVERED تم استلامها
OUT_OF_STOCK غير متوفّر.
IN_PREPARATION IN_PREPARATION ويمكن أن يكون لها معنى مختلف في سياق مختلف. بالنسبة إلى طلب الطعام، قد يكون الطعام جاريًا. بالنسبة إلى البيع بالتجزئة، قد يكون عنصرًا يتم تغليفه.
CREATED تم إنشاء الطلب.
CONFIRMED أكّد التاجر الطلب.
REJECTED رفض التاجر الطلب أو العنصر.
RETURNED تم إرجاع السلعة من قِبل المستخدم.
CANCELLED ألغى المستخدم الطلب أو العنصر.
CHANGE_REQUESTED طلب المستخدم إجراء تغيير على الطلب، وتعالج شركة الدمج هذا التغيير. يجب نقل الطلب إلى حالة أخرى بعد معالجة الطلب.

PurchaseType

فئة الشراء.

عمليات التعداد
PURCHASE_TYPE_UNSPECIFIED قيمة غير معروفة.
RETAIL ويشمل ذلك عمليات الشراء مثل السلع المادية.
FOOD ويشمل ذلك شراء طلب الطعام.
GROCERY شراء البقالة.
MOBILE_RECHARGE عملية شراء إعادة شحن رصيد الهاتف الجوّال المدفوعة مسبقًا.

MerchantUnitMeasure

مقياس تسعير وحدات التاجر

تمثيل JSON 
{
  "measure": number,
  "unit": enum (Unit)
}
الحقول
measure

number

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

unit

enum (Unit)

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

الوحدة

عمليات التعداد
UNIT_UNSPECIFIED لم يتم تحديد الوحدة.
MILLIGRAM مليغرام.
GRAM غرام
KILOGRAM كيلوغرام
OUNCE أوس.
POUND جنيه.

PurchaseReturnsInfo

عرض المعلومات المرتبطة بطلب أو بعنصر معيّن

تمثيل JSON 
{
  "isReturnable": boolean,
  "daysToReturn": number,
  "policyUrl": string
}
الحقول
isReturnable

boolean

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

daysToReturn

number

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

policyUrl

string

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

PurchaseFulfillmentInfo

معلومات توصيل الطلب المرتبطة بطلب الشراء أو بعنصر معيّن

تمثيل JSON 
{
  "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)
  }
}
الحقول
id

string

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

fulfillmentType

enum (Type)

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

expectedFulfillmentTime

object (Time)

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

expectedPreparationTime

object (Time)

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

location

object (Location)

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

expireTime

string (Timestamp format)

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

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

object (PriceAttribute)

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

fulfillmentContact

object (UserInfo)

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

shippingMethodName

string

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

storeCode

string

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

pickupInfo

object (PickupInfo)

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

النوع

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

عمليات التعداد
TYPE_UNSPECIFIED لم يتم تحديد النوع.
DELIVERY سيتم تسليم هذا الطلب.
PICKUP يجب استلام هذا الطلب.

الوقت

صيغة الوقت لتمثيل وقت الحدث لاستخدامه عند عرض طلب للمستخدم

تمثيل JSON 
{
  "timeIso8601": string
}
الحقول
timeIso8601

string

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

PickupInfo

تمثّل هذه السمة تفاصيل حول طريقة استلام الطلب. وهي تشمل تفاصيل مثل نوع استلام الطلب وبيانات وصفية إضافية مرفقة بكل نوع، إن توفّرت.

تمثيل JSON 
{
  "pickupType": enum (PickupType),
  "curbsideInfo": {
    object (CurbsideInfo)
  },
  "checkInInfo": [
    {
      object (CheckInInfo)
    }
  ]
}
الحقول
pickupType

enum (PickupType)

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

curbsideInfo

object (CurbsideInfo)

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

checkInInfo[]

object (CheckInInfo)

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

PickupType

قائمة بأنواع استلام الطلبات المتوافقة

عمليات التعداد
UNSPECIFIED لم يتم تحديد نوع استلام الطلب.
INSTORE لاستلام الطعام من داخل المطعم.
CURBSIDE ركن السيارة في مكان محدد خارج المطعم يقوم شخص ما بتوصيل الطعام هناك.

CurbsideInfo

تفاصيل حول كيفية تسهيل تقديم طلبات الإيصال إلى السيارة

تمثيل JSON 
{
  "curbsideFulfillmentType": enum (CurbsideFulfillmentType),
  "userVehicle": {
    object (Vehicle)
  }
}
الحقول
curbsideFulfillmentType

enum (CurbsideFulfillmentType)

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

userVehicle

object (Vehicle)

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

CurbsideFulfillmentType

القيم المحتملة لأنواع توصيل الطلبات إلى السيارة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد نوع تسليم السيارة إلى السيارة.
VEHICLE_DETAIL يجب توفير تفاصيل المركبة لتسهيل الاستلام من السيارة.

مركبة

تفاصيل حول مركبة

تمثيل JSON 
{
  "make": string,
  "model": string,
  "licensePlate": string,
  "colorName": string,
  "image": {
    object (Image)
  }
}
الحقول
make

string

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

model

string

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

licensePlate

string

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

colorName

string

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

image

object (Image)

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

CheckInInfo

البيانات الوصفية التي يطلبها الشريك لإتاحة طريقة تسجيل الوصول

تمثيل JSON 
{
  "checkInType": enum (CheckInType)
}
الحقول
checkInType

enum (CheckInType)

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

CheckInType

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

عمليات التعداد
CHECK_IN_TYPE_UNSPECIFIED قيمة غير معروفة.
EMAIL سيتم إرسال معلومات تسجيل الوصول عبر البريد الإلكتروني.
SMS سيتم إرسال معلومات تسجيل الوصول عبر الرسائل القصيرة SMS.

ItemOption

يمثل هذا الإعداد الإضافات أو العناصر الفرعية.

تمثيل JSON 
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": number,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
الحقول
id

string

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

name

string

اسم الخيار.

prices[]

object (PriceAttribute)

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

note

string

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

quantity

number

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

productId

string

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

subOptions[]

object (ItemOption)

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

ProductDetails

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

تمثيل JSON 
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
الحقول
productId

string

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

gtin

string

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

plu

string

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

productType

string

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

productAttributes

map (key: string, value: string)

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

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

ReservationItemExtension

محتويات العنصر لطلبات الحجز، مثل المطعم، وقص الشعر وما إلى ذلك. رقم التعريف التالي: 15.

تمثيل JSON 
{
  "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: ...,
    ...
  }
}
الحقول
status

enum (ReservationStatus)

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

userVisibleStatusLabel

string

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

type

enum (ReservationType)

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

reservationTime

object (Time)

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

userAcceptableTimeRange

object (Time)

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

confirmationCode

string

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

partySize

number

عدد الأشخاص.

staffFacilitators[]

object (StaffFacilitator)

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

location

object (Location)

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

extension

object

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

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

ReservationStatus

حالة الحجز.

عمليات التعداد
RESERVATION_STATUS_UNSPECIFIED حالة غير محدّدة
PENDING الحجز في انتظار المراجعة.
CONFIRMED تم تأكيد الحجز.
CANCELLED ألغى المستخدم الحجز.
FULFILLED يتم الحجز.
CHANGE_REQUESTED مطلوب تغيير الحجز
REJECTED انتهت صلاحية الحجز أو رفضته شركة الدمج.

ReservationType

نوع الحجز.

عمليات التعداد
RESERVATION_TYPE_UNSPECIFIED نوع غير محدَّد.
RESTAURANT حجز لمطعم.
HAIRDRESSER حجز لمصفّف الشعر.

StaffFacilitator

معلومات حول مقدّم الخدمة

تمثيل JSON 
{
  "name": string,
  "image": {
    object (Image)
  }
}
الحقول
name

string

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

image

object (Image)

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

PaymentData

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

تمثيل JSON 
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
الحقول
paymentResult

object (PaymentResult)

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

paymentInfo

object (PaymentInfo)

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

PaymentResult

نتيجة الدفع التي تستخدمها شركة الدمج لإكمال معاملة

تمثيل JSON 
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
الحقول
حقل الاتحاد result. تمّ تقديم بيانات الدفع من Google أو طريقة الدفع الخاصة بالتاجر. يمكن أن يكون result واحدًا فقط مما يلي:
googlePaymentData

string

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

merchantPaymentMethodId

string

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

PaymentInfo

معلومات الدفع المتعلقة بالطلب الذي يتم تقديمه. يجمع هذا النموذج المعلومات المفيدة للتفاعل المواجه للمستخدم.

تمثيل JSON 
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
الحقول
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

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

paymentMethodProvenance

enum (PaymentMethodProvenance)

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

PaymentMethodDisplayInfo

نتيجة الدفع التي تستخدمها شركة الدمج لإكمال معاملة

تمثيل JSON 
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string,
  "paymentMethodVoiceName": string
}
الحقول
paymentType

enum (PaymentType)

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

paymentMethodDisplayName

string

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

paymentMethodVoiceName

string

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

PaymentType

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

عمليات التعداد
PAYMENT_TYPE_UNSPECIFIED طريقة دفع غير محدّدة
PAYMENT_CARD بطاقة ائتمان أو بطاقة سحب آلي أو بطاقة دفع مسبق.
BANK طريقة الدفع هي حساب مصرفي.
LOYALTY_PROGRAM طريقة الدفع من برنامج الولاء.
CASH طريقة الدفع نقدًا.
GIFT_CARD طريقة الدفع هي بطاقة هدايا.
WALLET محفظة تابعة لجهة خارجية، مثل PayPal

PaymentMethodProvenance

تمثّل هذه السمة أصل طريقة الدفع المستخدَمة في المعاملة.

عمليات التعداد
PAYMENT_METHOD_PROVENANCE_UNSPECIFIED عدم تحديد المصدر
PAYMENT_METHOD_PROVENANCE_GOOGLE المصدر هو Google.
PAYMENT_METHOD_PROVENANCE_MERCHANT المصدر هو التاجر.

الترويج

العروض الترويجية أو العروض التي تمّت إضافتها إلى سلة التسوّق

تمثيل JSON 
{
  "coupon": string
}
الحقول
coupon

string

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

PurchaseOrderExtension

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

تمثيل JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
الحقول
status

enum (PurchaseStatus)

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

userVisibleStatusLabel

string

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

type

enum (PurchaseType)

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

returnsInfo

object (PurchaseReturnsInfo)

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

fulfillmentInfo

object (PurchaseFulfillmentInfo)

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

extension

object

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

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

enum (PurchaseLocationType)

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

errors[]

object (PurchaseError)

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

PurchaseLocationType

نوع الموقع الجغرافي لعملية الشراء

عمليات التعداد
UNSPECIFIED_LOCATION قيمة غير معروفة.
ONLINE_PURCHASE جميع عمليات الشراء التي تم شراؤها على الإنترنت.
INSTORE_PURCHASE جميع عمليات الشراء في المتجر

PurchaseError

الأخطاء التي يمكن أن يتم رفض طلب الشراء بسببها

تمثيل JSON 
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": number
}
الحقول
type

enum (ErrorType)

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

description

string

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

entityId

string

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

updatedPrice

object (PriceAttribute)

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

availableQuantity

number

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

ErrorType

أنواع الأخطاء المحتملة.

عمليات التعداد
ERROR_TYPE_UNSPECIFIED خطأ غير معروف
NOT_FOUND لم يتم العثور على الكيان، ويمكن أن يكون عنصرًا أو FulfillmentOption أو عرض ترويجي. يجب إدخال رقم تعريف الكيان.
INVALID بيانات الكيان غير صالحة. هي Item أو FulfillmentOption أو ترقية. يجب إدخال رقم تعريف الكيان.
AVAILABILITY_CHANGED السلعة غير متوفرة، أو العناصر غير الكافية لتلبية الطلب. يجب إدخال رقم تعريف الكيان.
PRICE_CHANGED سعر السلعة مختلفًا عن سعرها في كيان السلعة يجب إدخال رقم تعريف الكيان والسعر المعدَّل.
INCORRECT_PRICE أخطاء الأسعار في الرسوم، الإجمالي يجب إدخال رقم تعريف الكيان والسعر المعدَّل.
REQUIREMENTS_NOT_MET قيود قبول الطلب - الحد الأدنى لحجم سلة التسوّق إلخ
TOO_LATE انتهت صلاحية FulfillmentOption.
NO_CAPACITY لا تتوفّر سعة خدمة.
INELIGIBLE المستخدم غير مؤهّل لتقديم طلب (تم إدراجه في القائمة السوداء).
OUT_OF_SERVICE_AREA يتعذّر التسليم إلى العنوان المطلوب بسبب القواعد الحدودية وما إلى ذلك.
CLOSED المطعم مغلق للعمل في وقت الطلب.
PROMO_NOT_APPLICABLE رمز خطأ عام لرصد جميع حالات عدم استخدام الرمز الترويجي، إذا لم يكن أيّ من الحالات التالية مناسبًا. إضافة الرمز الترويجي كرقم تعريف الكيان.
PROMO_NOT_RECOGNIZED لم يتعرّف الشريك على رمز القسيمة. إضافة الرمز الترويجي كرقم تعريف الكيان.
PROMO_EXPIRED تعذّر تطبيق الطلب بسبب انتهاء صلاحية العرض الترويجي. إضافة الرمز الترويجي كرقم تعريف الكيان.
PROMO_USER_INELIGIBLE المستخدم الحالي غير مؤهل للحصول على هذه القسيمة. إضافة الرمز الترويجي كرقم تعريف الكيان.
PROMO_ORDER_INELIGIBLE الطلب الحالي غير مؤهّل للحصول على هذه القسيمة. إضافة الرمز الترويجي كرقم تعريف الكيان.
UNAVAILABLE_SLOT خانة الطلب المسبق غير متاحة.
FAILED_PRECONDITION قيود قبول الطلب - الحد الأدنى لحجم سلة التسوّق وما إلى ذلك
PAYMENT_DECLINED دفعة غير صالحة.
MERCHANT_UNREACHABLE لا يمكن الوصول إلى التاجر. ويساعد ذلك في الحالات التي يكون فيها الشريك مجمّع سلع ولا يمكنه الوصول إلى التاجر.

TicketOrderExtension

اطلب محتوى طلبات التذاكر، مثل الأفلام والفعاليات الرياضية وغيرها.

تمثيل JSON 
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
الحقول
ticketEvent

object (TicketEvent)

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

TicketEvent

ويمثل حدثًا واحدًا.

تمثيل JSON 
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
الحقول
type

enum (Type)

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

name

string

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

description

string

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

url

string

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

location

object (Location)

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

eventCharacters[]

object (EventCharacter)

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

startDate

object (Time)

وقت البدء

endDate

object (Time)

وقت الانتهاء

doorTime

object (Time)

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

النوع

نوع الحدث.

عمليات التعداد
EVENT_TYPE_UNKNOWN نوع حدث غير معروف.
MOVIE فيلم.
CONCERT حفلة موسيقية.
SPORTS الرياضة.

EventCharacter

حرف حدث واحد، مثل المنظّم أو المؤدي وما إلى ذلك

تمثيل JSON 
{
  "type": enum (Type),
  "name": string,
  "image": {
    object (Image)
  }
}
الحقول
type

enum (Type)

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

name

string

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

image

object (Image)

صور الشخصية.

النوع

نوع الحرف.

عمليات التعداد
TYPE_UNKNOWN نوع غير معروف.
ACTOR ممثل
PERFORMER مؤدي عروض.
DIRECTOR المخرِج
ORGANIZER المنظِّم.