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

userVisibleOrderId

string

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

userVisibleStateLabel
(deprecated)

string

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

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)

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

PhoneNumber

التمثيل القياسي لرقم الهاتف.

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

string

رقم الهاتف بالتنسيق E.164، على النحو المحدَّد في اقتراح الاتحاد الدولي للاتصالات (ITU) رقم E.164. رابط 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

اسم التاجر مثل "Panera Bread".

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

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

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

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

نصائح حول إدخال أو تعديل العنوان: - استخدِم أداة عنوان جاهزة للاستخدام، مثل 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 لمحتوى هذا العنوان (إذا كان معروفًا). وغالبًا ما تكون هذه اللغة هي لغة واجهة المستخدم في نموذج الإدخال، أو يُتوقّع أن تتطابق مع إحدى اللغات المستخدَمة في بلد أو منطقة العنوان أو ما يكافئها صوتيًا. يمكن أن يؤثر هذا على التنسيق في بلدان معينة، لكنه ليس بالغ الأهمية لصحة البيانات ولن يؤثر أبدًا على أي عمليات تحقق أو عمليات أخرى غير متعلقة بالتنسيق.

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

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

postalCode

string

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

sortingCode

string

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

administrativeArea

string

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

locality

string

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

sublocality

string

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

addressLines[]

string

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

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

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

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

recipients[]

string

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

organization

string

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

الفهرس

برنامج تغليف العناصر.

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

object (LineItem)

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

Type

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

عمليات التعداد
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

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

عمليات التعداد
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 الذي يمكن أن يكون أيًا مما يلي: - عناوين URL التي تستخدم http/https لفتح تطبيق مرتبط بتطبيق أو صفحة ويب

androidApp

object (AndroidApp)

هي معلومات عن تطبيق Android إذا كان من المتوقّع أن يستوفي أحد تطبيقات Android عنوان URL.

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 Ounce
POUND جنيه

PurchaseReturnsInfo

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

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

boolean

وفي حال اختيار "صحيح"، يُسمح بالإرجاع.

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)

نافذة في حال تحديد نطاق زمني أو ETA في حال تحديد نطاق زمني واحد. الوقت المتوقّع للتسليم أو الاستلام

expectedPreparationTime

object (Time)

نافذة في حال تحديد نطاق زمني أو ETA في حال تحديد نطاق زمني واحد. الوقت المتوقع لإعداد الطعام. يُفضَّل استخدامه لمرة واحدة.

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 هو التاجر ورمز المتجر هو متجر Walmart الذي تم توصيل الطلب إليه. https://support.google.com/business/answer/3370250?ref_topic=4596653.

pickupInfo

object (PickupInfo)

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

Type

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

عمليات التعداد
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

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

model

string

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

licensePlate

string

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

colorName

string

اسم لون المركبة، على سبيل المثال الأسود (اختياري)

image

object (Image)

عنوان URL يؤدي إلى صورة للمركبة سيتم عرض الصورة بحجم 256x256 بكسل تقريبًا. يجب أن يكون بتنسيق 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)

التفاصيل التي يقدّمها التاجر حول المنتج، مثل { "allergen": "peanut" }. تكون هذه المعلومات مفيدة إذا لم يكن OfferId متوفّرًا في 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 الحساب الجاري **** 5678

paymentMethodVoiceName

string

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

PaymentType

يشير 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 لم يتم العثور على الكيان، ويمكن أن يكون العنصر أو خيار توصيل الطلب أو العرض الترويجي. رقم تعريف الكيان مطلوب.
INVALID بيانات الكيان غير صالحة. يمكن أن تشمل السلعة أو 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 صباحًا

Type

نوع الحدث.

عمليات التعداد
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

نوع الحرف

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