- تمثيل JSON
- UserInfo
- PhoneNumber
- الصورة
- التاجر
- الموقع الجغرافي
- LatLng
- PostalAddress
- المحتوى
- LineItem
- PriceAttribute
- النوع
- الولاية
- مبلغ مالي
- الإجراء
- النوع
- OpenUrlAction
- AndroidApp
- VersionFilter
- UrlTypeHint
- ActionMetadata
- الإفصاح
- DisclosureText
- TextLink
- DisclosurePresentationOptions
- PresentationRequirement
- PurchaseItemExtension
- PurchaseStatus
- PurchaseType
- MerchantUnitMeasure
- الوحدة
- PurchaseReturnsInfo
- PurchaseFulfillmentInfo
- النوع
- الوقت
- PickupInfo
- PickupType
- CurbsideInfo
- CurbsideFulfillmentType
- مركبة
- CheckInInfo
- CheckInType
- ItemOption
- ProductDetails
- ReservationItemExtension
- ReservationStatus
- ReservationType
- StaffFacilitator
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- PaymentType
- PaymentMethodProvenance
- العرض الترويجي
- PurchaseOrderExtension
- PurchaseLocationType
- PurchaseError
- ErrorType
- TicketOrderExtension
- TicketEvent
- النوع
- EventCharacter
- النوع
كيان الطلب. ملاحظة: 1. يجب أن تكون جميع السلاسل في جميع المستويات أقل من 1000 حرف ما لم يتم تحديد خلاف ذلك. 2. يجب أن تكون جميع الحقول المتكرّرة في جميع المستويات أقل من 50 في العدد ما لم يتم تحديد خلاف ذلك. 3. يجب أن تكون جميع الطوابع الزمنية على جميع المستويات، إذا تم تحديدها، طوابع زمنية صالحة.
تمثيل JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
الحقول | ||
---|---|---|
googleOrderId |
مُعرّف الطلب المخصّص لشركة Google |
|
merchantOrderId |
مطلوب: حصل التاجر على مُعرّف الطلب الداخلي. يجب أن يكون هذا المعرّف فريدًا ومطلوبًا لعمليات تعديل الطلبات اللاحقة. ويمكن ضبط هذا المعرّف على قيمة googleOrderId المقدَّمة أو أي قيمة فريدة أخرى. يُرجى العلم أنّ رقم التعريف المعروض للمستخدمين هو uservisibleOrderId، وقد يكون هذا المعرّف قيمة مختلفة وسهلة الاستخدام. الحد الأقصى المسموح به للطول هو 128 حرفًا. |
|
userVisibleOrderId |
تمثّل هذه السمة معرّف المستخدم الذي يشير إلى الطلب الحالي. ويجب أن يكون هذا المعرّف متسقًا مع المعرّف المعروض لهذا الطلب في السياقات الأخرى، بما في ذلك المواقع الإلكترونية والتطبيقات والبريد الإلكتروني. |
|
userVisibleStateLabel |
مهملة: يمكنك استخدام حالة OrderExtensions بدلاً من ذلك. تصنيف مرئي للمستخدم لحالة هذا الطلب. |
|
buyerInfo |
معلومات حول المشتري. |
|
image |
صورة مرتبطة بالطلب |
|
createTime |
مطلوب: تاريخ ووقت إنشاء الطلب يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
|
lastUpdateTime |
تاريخ ووقت آخر تعديل للطلب مطلوبة من أجل OrderUpdate يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
|
transactionMerchant |
التاجر الذي سهّل عملية الدفع وقد يختلف هذا عن مقدّم الخدمات على مستوى العنصر. مثال: طلب Expedia يحتوي على بند من ANA. |
|
contents |
مطلوب: محتوى الطلب الذي هو مجموعة من العناصر. |
|
priceAttributes[] |
السعر والخصومات والضرائب وما إلى ذلك. |
|
followUpActions[] |
إجراءات المتابعة على مستوى الطلب |
|
paymentData |
البيانات المتعلّقة بالدفع مقابل الطلب |
|
termsOfServiceUrl |
رابط لبنود الخدمة التي تنطبق على الطلب/الطلب المقترح. |
|
note |
الملاحظات المرفقة بالطلب |
|
promotions[] |
جميع العروض الترويجية المرتبطة بهذا الطلب. |
|
disclosures[] |
الإفصاحات المرتبطة بهذا الطلب |
|
vertical |
مهملة: يمكنك استخدام مواضع الإعلانات بدلاً من ذلك. وسيتم تطبيق هذه السمات على جميع العناصر، ما لم يتم إلغاؤها في بعض العناصر. يجب أن يتطابق هذا المجال مع نوع موضع الإعلان على مستوى العنصر. القيم المتاحة: كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
|
حقل الاتحاد verticals وسيتم تطبيق هذه السمات على جميع العناصر، ما لم يتم إلغاؤها في بعض العناصر. يجب أن يتطابق هذا المجال مع نوع موضع الإعلان على مستوى العنصر. يمكن أن تكون السمة "verticals " واحدة فقط مما يلي: |
||
purchase |
طلب الشراء |
|
ticket |
طلب التذكرة |
UserInfo
معلومات حول المستخدم تُستخدَم هذه البيانات لتمثيل معلومات المستخدم المرتبط بطلب معيّن.
تمثيل JSON | |
---|---|
{
"email": string,
"firstName": string,
"lastName": string,
"displayName": string,
"phoneNumbers": [
{
object ( |
الحقول | |
---|---|
email |
البريد الإلكتروني للمستخدم، على سبيل المثال: janedoe@gmail.com. |
firstName |
الاسم الأوّل للمستخدِم |
lastName |
اسم العائلة للمستخدِم. |
displayName |
قد يكون الاسم المعروض للمستخدم مختلفًا عن الاسم الأول أو اسم العائلة. |
phoneNumbers[] |
أرقام هواتف المستخدم |
PhoneNumber
التمثيل القياسي لرقم الهاتف.
تمثيل JSON | |
---|---|
{ "e164PhoneNumber": string, "extension": string, "preferredDomesticCarrierCode": string } |
الحقول | |
---|---|
e164PhoneNumber |
رقم الهاتف بالتنسيق E.164، على النحو المحدَّد في اقتراح الاتحاد الدولي للاتصالات (ITU) رقم E.164. رابط wiki: https://en.wikipedia.org/wiki/E.164 |
extension |
لم يتم توحيد الامتداد في توصيات الاتحاد الدولي للاتصالات، باستثناء تعريفه على أنه سلسلة من الأرقام يبلغ طولها 40 رقمًا بحد أقصى. وتعريفها كسلسلة هنا لتلائم الاستخدام المحتمل لصفر بادئ في الإضافة (للمؤسسات حرية كاملة لإجراء ذلك، لأنه لا يوجد معيار محدد). بخلاف الأرقام، قد يتم تخزين بعض أحرف الاتصال الأخرى، مثل "," (التي تشير إلى الانتظار) هنا. على سبيل المثال، في xxx-xxx-xxxx الرقم الداخلي 123، يمثل الرقم "123" امتدادًا. |
preferredDomesticCarrierCode |
رمز اختيار مشغل شبكة الجوّال المفضل عند الاتصال برقم الهاتف هذا محليًا. ويشمل هذا أيضًا الرموز التي يجب الاتصال بها في بعض البلدان عند الاتصال من الخطوط الأرضية إلى الهواتف الجوّالة أو العكس. على سبيل المثال، في كولومبيا، يجب الاتصال بالرقم "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 |
عنوان URL المصدر للصورة ويمكن أن تكون الصور بتنسيق JPG وPNG وGIF (الرسوم المتحركة وغير المتحركة). مثلاً، |
accessibilityText |
وصف نصي للصورة الذي سيتم استخدامه لتسهيل الاستخدام، مثل برامج قراءة الشاشة. مطلوبة. |
height |
ارتفاع الصورة بالبكسل. اختياريّ. |
width |
عرض الصورة بالبكسل. اختياريّ. |
التاجر
التاجر لسلة التسوق/الطلب/العنصر.
تمثيل JSON | |
---|---|
{ "id": string, "name": string, "image": { object ( |
الحقول | |
---|---|
id |
معرّف اختياري تم تعيينه للتاجر إن توفّر |
name |
اسم التاجر مثل "Panera Bread". |
image |
الصورة المرتبطة بالتاجر |
phoneNumbers[] |
أرقام هواتف التاجر |
address |
عنوان التاجر: |
الموقع الجغرافي
حاوية تمثّل موقعًا جغرافيًا.
تمثيل JSON | |
---|---|
{ "coordinates": { object ( |
الحقول | |
---|---|
coordinates |
الإحداثيات الجغرافية. يتطلب ذلك [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION]. |
formattedAddress |
العنوان المعروض، على سبيل المثال "1600 Amphitheatre Pkwy, Mountain View, CA 94043". يتطلب ذلك [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION]. |
zipCode |
الرمز البريدي يتطلب إذن [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] أو [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
city |
المدينة يتطلب إذن [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] أو [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
postalAddress |
العنوان البريدي. يتطلب إذن [DEVICE_PRECISE_LOCATION] [google.actions.v2.Permission.DEVICE_PRECISE_LOCATION] أو [DEVICE_COARSE_LOCATION] [google.actions.v2.Permission.DEVICE_COARSE_LOCATION]. |
name |
اسم المكان. |
phoneNumber |
رقم هاتف الموقع الجغرافي، مثل رقم جهة الاتصال بالموقع الجغرافي للنشاط التجاري أو رقم هاتف لموقع التسليم |
notes |
ملاحظات حول الموقع الجغرافي |
placeId |
يتم استخدام رقم تعريف المكان مع واجهة برمجة تطبيقات الأماكن لجلب تفاصيل أحد الأماكن. لمعرفة مزيد من المعلومات، يُرجى الانتقال إلى https://developers.google.com/places/web-service/place-id. |
LatLng
عنصر يمثّل زوجًا من خط العرض/خط الطول. يتم التعبير عن ذلك كزوج من الازدواج يمثلان درجات خط العرض وخط الطول بالدرجات. يجب أن يتوافق هذا مع معيار WGS84 ما لم يتم تحديد خلاف ذلك. يجب أن تكون القيم ضمن نطاقات تمت تسويتها.
تمثيل JSON | |
---|---|
{ "latitude": number, "longitude": number } |
الحقول | |
---|---|
latitude |
تمثّل هذه السمة خط العرض بالدرجات. يجب أن يكون ضِمن نطاق [ -90.0 أو +90.0]. |
longitude |
خط الطول بالدرجات. يجب أن يكون ضمن النطاق [-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 |
النسخة السابقة من المخطط من يجب أن تكون جميع النُسخ الجديدة متوافقة مع الإصدارات القديمة. |
regionCode |
مطلوبة. رمز CLDR للمنطقة للدولة/المنطقة حيث يقع العنوان لا يتم استنتاج هذه المعلومات على الإطلاق، وعلى المستخدم التأكّد من صحة القيمة. يمكنك الانتقال إلى http://cldr.unicode.org/ وhttp://www.unicode.org/cldr/charts/30/supplemental/territory_information.html للحصول على مزيد من التفاصيل. على سبيل المثال: "CH" لسويسرا. |
languageCode |
اختياريّ. رمز اللغة BCP-47 لمحتوى هذا العنوان (إذا كان معروفًا). وغالبًا ما تكون هذه اللغة هي لغة واجهة المستخدم في نموذج الإدخال، أو يُتوقّع أن تتطابق مع إحدى اللغات المستخدَمة في بلد أو منطقة العنوان أو ما يكافئها صوتيًا. يمكن أن يؤثر هذا على التنسيق في بلدان معينة، لكنه ليس بالغ الأهمية لصحة البيانات ولن يؤثر أبدًا على أي عمليات تحقق أو عمليات أخرى غير متعلقة بالتنسيق. إذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة). أمثلة: "sa-Hant" و"ja" و"ja-Latn" و"en". |
postalCode |
اختياريّ. الرمز البريدي للعنوان لا تستخدم جميع البلدان الرموز البريدية أو تشترطها، ولكن في أماكن استخدامها، قد تبدأ عملية تحقّق إضافية من خلال استخدام أجزاء أخرى من العنوان (مثل إثبات صحة البيانات حسب الولاية أو الرمز البريدي في الولايات المتحدة الأمريكية). |
sortingCode |
اختياريّ. رمز ترتيب إضافي خاص بالبلد ولا يتم استخدام هذه الطريقة في معظم المناطق. وعند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة برقم اختياري (مثل "CEDEX 7")، أو رقم فقط يمثّل "رمز القطاع" (Jamaica) أو "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (مثل ساحل العاج). |
administrativeArea |
اختياريّ. أعلى تقسيم فرعي إداري يُستخدم للعناوين البريدية لبلد أو منطقة. على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. وعلى وجه التحديد، بالنسبة إلى إسبانيا، تكون هذه المقاطعة وليست المجتمع المستقل (مثل "برشلونة" وليس "كاتالونيا"). لا يستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. في سويسرا مثلاً، يجب ترك هذا الحقل فارغًا. |
locality |
اختياريّ. يشير بوجه عام إلى جزء المدينة/البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، مدينة البريد في المملكة المتحدة. في مناطق العالم حيث لم يتم تعريف المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل بشكل جيد، اترك المنطقة المحلية فارغة واستخدم addressLines. |
sublocality |
اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن يشمل ذلك الأحياء والأحياء والأحياء. |
addressLines[] |
أسطر عناوين غير مهيكلة تصف المستويات الأدنى من العنوان. نظرًا لأن القيم في addressLines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "Austin, TX")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب سطور العنوان هو "ترتيب المغلف" للبلد/منطقة العنوان. وفي الأماكن التي يمكن أن يختلف فيها ذلك (مثل اليابان)، يتم استخدام address_language لجعله واضحًا (مثل "ja" للطلبات الكبيرة إلى الصغيرة و "ja-Latn" أو "en" للأحجام الصغيرة إلى الكبيرة). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا في العنوان استنادًا إلى اللغة. يتألف الحد الأدنى المسموح به من التمثيل الهيكلي للعنوان من رمز المنطقة مع وضع جميع المعلومات المتبقية في سطور العنوان. وكان من الممكن تنسيق مثل هذا العنوان بشكل تقريبي بدون ترميز جغرافي، ولكن لا يمكن الاستدلال على أي من مكونات العنوان حتى يتم حله جزئيًا على الأقل. إنشاء عنوان يحتوي فقط على رمز المنطقة وaddressLines، ومن ثم الترميز الجغرافي هو الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية). |
recipients[] |
اختياريّ. المستلم في العنوان. قد يحتوي هذا الحقل، في ظروف معيّنة، على معلومات متعددة الأسطر. على سبيل المثال، قد تحتوي على معلومات حول "الاهتمام". |
organization |
اختياريّ. اسم المؤسسة في العنوان. |
الفهرس
برنامج تغليف العناصر.
تمثيل JSON | |
---|---|
{
"lineItems": [
{
object ( |
الحقول | |
---|---|
lineItems[] |
قائمة عناصر الطلب. يجب إدخال عنصر واحد على الأقل، ويُسمح باستخدام 50 عنصرًا كحدّ أقصى. يجب أن تنتمي جميع البنود إلى المجال نفسه. |
LineItem
يحتوي عنصر واحد على موضع إعلان واحد. يمكن أن يحتوي الطلب أو سلة التسوق على عناصر متعددة من المجال نفسه. يجب تحديد عناصر الأسطر الفرعية/الإضافات وما إلى ذلك في النماذج الأوّلية الرأسية اعتمادًا على حالات استخدامها. ملاحظة: 1. يجب أن تكون جميع السلاسل في جميع المستويات أقل من 1000 حرف ما لم يتم تحديد خلاف ذلك. 2. يجب أن تكون جميع الحقول المتكرّرة في جميع المستويات أقل من 50 في العدد ما لم يتم تحديد خلاف ذلك. 3. يجب أن تكون جميع الطوابع الزمنية على جميع المستويات، إذا تم تحديدها، طوابع زمنية صالحة.
تمثيل JSON | |
---|---|
{ "id": string, "name": string, "userVisibleStateLabel": string, "provider": { object ( |
الحقول | ||
---|---|---|
id |
مطلوب: معرّف التاجر الذي عيّنه للعنصر. تُستخدَم لتحديد العنصر الحالي عند تطبيق التعديلات الجزئية. الحد الأقصى المسموح به للطول هو 64 حرفًا. |
|
name |
اسم البند كما هو معروض في الإيصال. الحد الأقصى المسموح به للطول هو 100 حرف. |
|
userVisibleStateLabel |
تمّ الإيقاف. استخدِم الحالة على المستوى العمودي بدلاً من ذلك. على سبيل المثال، بالنسبة إلى عمليات الشراء، يمكنك استخدام purchaseOrderExtension.status. تصنيف مرئي للمستخدم لحالة هذا العنصر. |
|
provider |
تمثّل هذه السمة موفِّر العنصر المعيّن، إذا كان مختلفًا عن الطلب الكلي. مثال: طلب Expedia من خلال مزوّد تفاصيل الإعلانات ANA |
|
priceAttributes[] |
السعر والتسويات على مستوى العنصر |
|
followUpActions[] |
إجراءات المتابعة على البند. |
|
recipients[] |
للعملاء على مستوى العنصر، قد يختلف هذا العنصر عن المشتري على مستوى الطلب. مثال: أجرى المستخدم "س" حجز مطعم باسم المستخدم "ص". |
|
image |
صورة صغيرة مرتبطة بهذا العنصر، إن توفّرت. |
|
description |
وصف العنصر. |
|
notes[] |
ملاحظات إضافية تنطبق على هذا العنصر تحديدًا، على سبيل المثال سياسة الإلغاء. |
|
disclosures[] |
الإفصاحات المرتبطة بهذا العنصر |
|
vertical |
مهملة: يمكنك استخدام مواضع الإعلانات بدلاً من ذلك. مطلوب: المحتوى الدلالي للعنصر بناءً على نوعه أو مجاله. يجب أن يتضمن كل مجال تفاصيل توصيله. يجب استخدام إحدى القيمتَين التاليتَين: كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
|
حقل الاتحاد verticals مطلوب: المحتوى الدلالي للعنصر بناءً على نوعه أو مجاله. يجب أن يتضمن كل مجال تفاصيل توصيله. يمكن أن تكون السمة "verticals " واحدة فقط مما يلي: |
||
purchase |
طلبات الشراء مثل السلع والأطعمة وغيرها |
|
reservation |
طلبات الحجز مثل المطاعم وقص الشعر وما إلى ذلك |
PriceAttribute
سمة السعر لطلب أو عنصر.
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | ||
---|---|---|
type |
مطلوب: سمة نوع الأموال. |
|
name |
مطلوب: يعرض المستخدم سلسلة سمة السعر. يُرسل التاجر هذه المعلومات وترجمتها. |
|
state |
مطلوب: حالة السعر: تقديري في مقابل الفعلي. |
|
taxIncluded |
ما إذا كان السعر يشمل الضريبة. |
|
حقل الاتحاد spec يمثل مبلغًا نقديًا أو نسبة مئوية بالمللي ثانية. يمكن أن تكون السمة "spec " واحدة فقط مما يلي: |
||
amount |
المبلغ النقدي |
|
amountMillipercentage |
مواصفات النسبة المئوية، حتى 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 |
تمثّل هذه السمة رمز العملة المكوَّن من 3 أحرف والمحدد في ISO 4217. |
amountInMicros |
المبلغ بوحدات المايكرو. على سبيل المثال، يجب ضبط هذا الحقل على 1990000 مقابل 1.99 دولار أمريكي (أو ما يعادله بالعملة المحلية). |
الإجراء
إجراء متابعة مرتبط بالطلب أو العنصر.
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | |
---|---|
type |
مطلوب: نوع الإجراء |
title |
عنوان الإجراء أو تصنيفه، المعروض للمستخدم. الحد الأقصى المسموح به للطول هو 100 حرف. |
openUrlAction |
الإجراء المطلوب اتخاذه. |
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 ( |
الحقول | |
---|---|
url |
حقل عنوان URL الذي يمكن أن يكون أيًا مما يلي: - عناوين URL التي تستخدم http/https لفتح تطبيق مرتبط بتطبيق أو صفحة ويب |
androidApp |
هي معلومات عن تطبيق Android إذا كان من المتوقّع أن يستوفي أحد تطبيقات Android عنوان URL. |
urlTypeHint |
تشير هذه السمة إلى نوع عنوان URL. |
AndroidApp
مواصفات تطبيق Android للقيود المفروضة على تنفيذ الطلبات
تمثيل JSON | |
---|---|
{
"packageName": string,
"versions": [
{
object ( |
الحقول | |
---|---|
packageName |
اسم الحزمة يجب تحديد اسم الحزمة عند تحديد Android Fulfillment. |
versions[] |
عند تحديد فلاتر متعددة، ستؤدي أي مطابقة للفلتر إلى تشغيل التطبيق. |
VersionFilter
يجب تضمين VersionFilter إذا كانت هناك إصدارات معيَّنة من التطبيق مطلوبة.
تمثيل JSON | |
---|---|
{ "minVersion": number, "maxVersion": number } |
الحقول | |
---|---|
minVersion |
رمز الإصدار الأدنى أو 0، شامل. |
maxVersion |
رمز الإصدار الأقصى، شامل. النطاق الذي يتم أخذه في الاعتبار هو [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 |
الوقت الذي ستنتهي فيه صلاحية هذا الإجراء. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
الإفصاح
هو الإفصاح عن المنتج أو الخدمة أو السياسة التي يمكن تقديمها للمستخدم.
تمثيل JSON | |
---|---|
{ "title": string, "disclosureText": { object ( |
الحقول | |
---|---|
title |
عنوان الإفصاح. مثال: "معلومات السلامة". |
disclosureText |
محتوى الإفصاح: يُسمح باستخدام روابط الويب. |
presentationOptions |
خيارات العرض التقديمي لبيان الإفصاح |
DisclosureText
تُمثِّل نصًا عاديًا يتضمّن روابط ويب.
تمثيل JSON | |
---|---|
{
"template": string,
"textLinks": [
{
object ( |
الحقول | |
---|---|
template |
نص للعرض، يحتوي على عناصر نائبة مثل "{0}" و "{1}" لكل رابط نصي يجب إدراجه. مثال: "تحذير: يمكن أن يعرّضك هذا المنتج للمواد الكيميائية المعروفة لولاية كاليفورنيا بأنها تسبب السرطان. لمزيد من المعلومات، يُرجى الانتقال إلى {0}." يجب ألا يتضمّن نص الإفصاح هذا أي محتوى ترويجي أو يشبه الإعلانات. |
textLinks[] |
يشير ذلك المصطلح إلى الروابط النصية التي يجب استبدالها في النموذج. سيتم استبدال الرقم الأول بـ "{0}" في سلسلة النموذج، والآخر بـ "{1}"، وما إلى ذلك. |
TextLink
تمثّل هذه السمة رابط نصي يجب استبداله في النموذج.
تمثيل JSON | |
---|---|
{ "displayText": string, "url": string } |
الحقول | |
---|---|
displayText |
النص الذي يجب عرضه للمستخدمين. |
url |
عنوان URL الذي يجب توجيه المستخدمين إليه عند تفعيل الرابط. |
DisclosurePresentationOptions
خيارات عرض الإفصاح.
تمثيل JSON | |
---|---|
{
"presentationRequirement": enum ( |
الحقول | |
---|---|
presentationRequirement |
متطلبات العرض التقديمي للإفصاح: |
initiallyExpanded |
ما إذا كان يجب توسيع محتوى بيان الإفصاح في البداية أم لا. ويتم تصغيرها مبدئيًا تلقائيًا. |
PresentationRequirement
متطلبات تقديم الإفصاح.
عمليات التعداد | |
---|---|
REQUIREMENT_UNSPECIFIED |
مطلب غير محدد. يجب عدم ضبط هذه السمة بشكل صريح. |
REQUIREMENT_OPTIONAL |
الإفصاح اختياري. ويمكن تخطّيه إذا كان الجهاز لا يتيح عرض بيانات الإفصاح. |
REQUIREMENT_REQUIRED |
يجب الإفصاح عن جهة تمويل الإعلان. سيتم توجيه المحادثة إلى الهاتف إذا كان الجهاز لا يتيح عرض الإفصاحات. |
PurchaseItemExtension
محتوى العنصر في قطاع الشراء
تمثيل JSON | |
---|---|
{ "status": enum ( |
الحقول | |
---|---|
status |
مطلوب: الحالة على مستوى العنصر. |
userVisibleStatusLabel |
مطلوب: تصنيف/سلسلة مرئية للمستخدم للحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا. |
type |
مطلوب: نوع الشراء |
productId |
معرّف المنتج أو العرض المرتبط بهذا العنصر. |
quantity |
كمية السلعة |
unitMeasure |
قياس الوحدة. تحدّد حجم السلعة في الوحدات المختارة. يتمّ استخدام المقاس والسعر النشط لتحديد سعر الوحدة. |
returnsInfo |
تعرض معلومات لهذا العنصر. في حال ترك هذه السياسة بدون ضبط، يكتسب هذا العنصر معلومات حول مستوى الطلب. |
fulfillmentInfo |
معلومات توصيل الطلب لهذا العنصر. في حال ترك هذه السياسة بدون ضبط، يكتسب هذا العنصر معلومات طريقة التنفيذ على مستوى الطلب. |
itemOptions[] |
العناصر الفرعية أو الإضافات الإضافية |
extension |
أي حقول إضافية يتم تبادلها بين التاجر وGoogle. كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
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 ( |
الحقول | |
---|---|
measure |
القيمة: المثال 1.2. |
unit |
الوحدة: مثال على POUND وGRAM |
الوحدة
عمليات التعداد | |
---|---|
UNIT_UNSPECIFIED |
لم يتم تحديد الوحدة. |
MILLIGRAM |
مليغرام. |
GRAM |
"غرام". |
KILOGRAM |
كيلوغرام. |
OUNCE |
Ounce |
POUND |
جنيه |
PurchaseReturnsInfo
تعرض معلومات مرتبطة بطلب أو عنصر معيّن.
تمثيل JSON | |
---|---|
{ "isReturnable": boolean, "daysToReturn": number, "policyUrl": string } |
الحقول | |
---|---|
isReturnable |
وفي حال اختيار "صحيح"، يُسمح بالإرجاع. |
daysToReturn |
يُسمح بإرجاع المنتج خلال هذه الأيام العديدة. |
policyUrl |
رابط يؤدي إلى سياسة الإرجاع |
PurchaseFulfillmentInfo
معلومات توصيل الطلبات المرتبطة بطلب شراء أو بند معيّن.
تمثيل JSON | |
---|---|
{ "id": string, "fulfillmentType": enum ( |
الحقول | |
---|---|
id |
المعرّف الفريد لخيار الخدمة هذا. |
fulfillmentType |
مطلوب: نوع توصيل الطلب |
expectedFulfillmentTime |
نافذة في حال تحديد نطاق زمني أو ETA في حال تحديد نطاق زمني واحد. الوقت المتوقّع للتسليم أو الاستلام |
expectedPreparationTime |
نافذة في حال تحديد نطاق زمني أو ETA في حال تحديد نطاق زمني واحد. الوقت المتوقع لإعداد الطعام. يُفضَّل استخدامه لمرة واحدة. |
location |
موقع الاستلام أو التوصيل: |
expireTime |
الوقت الذي تنتهي فيه صلاحية خيار توصيل الطلب هذا. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقّة تصل إلى نانوثانية. مثال: |
price |
تكلفة هذا الخيار. |
fulfillmentContact |
جهة اتصال المستخدم المسؤولة عن عملية التنفيذ هذه |
shippingMethodName |
اسم طريقة الشحن التي اختارها المستخدم. |
storeCode |
رمز المتجر للموقع الجغرافي. مثال: Walmart هو التاجر ورمز المتجر هو متجر Walmart الذي تم توصيل الطلب إليه. https://support.google.com/business/answer/3370250?ref_topic=4596653. |
pickupInfo |
معلومات إضافية حول كيفية اختيار الطلب لن ينطبق هذا الحقل إلا عندما يكون نوع التنفيذ هو PICKUP. |
Type
نوع توصيل الطلب
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED |
لم يتم تحديد النوع. |
DELIVERY |
سيتم تسليم هذا الطلب. |
PICKUP |
يجب استلام هذا الطلب. |
الوقت
بنية زمنية لتمثيل وقت حدث يمكن استخدامه عند عرض طلب للمستخدم.
تمثيل JSON | |
---|---|
{ "timeIso8601": string } |
الحقول | |
---|---|
timeIso8601 |
تمثّل هذه السمة وقت حدث الطلب، مثل وقت الحجز ووقت التسليم وغير ذلك. ويمكن أن تكون المدة (وقت البدء ووقت الانتهاء)، والتاريخ والوقت فقط وما إلى ذلك. ويمكنك الرجوع إلى https://en.wikipedia.org/wiki/ISO_8601 للاطّلاع على جميع التنسيقات المتوافقة. |
PickupInfo
تفاصيل حول كيفية استلام الطلب وهي تتضمّن تفاصيل مثل نوع الاستلام والبيانات الوصفية الإضافية المرفقة مع كل نوع، إن توفّرت.
تمثيل JSON | |
---|---|
{ "pickupType": enum ( |
الحقول | |
---|---|
pickupType |
طريقة الاستلام، مثل INSTORE وCURBSIDE وغير ذلك |
curbsideInfo |
تمثّل هذه السمة تفاصيل خاصة بالمعلومات عن السيارة. إذا لم تكن قيمة pickupType (نوع الاستلام) هي CURBSIDE، سيتم تجاهل هذا الحقل. |
checkInInfo[] |
قائمة بالطرق المختلفة التي يوفّرها الشريك لدعم تسجيل الوصول |
PickupType
قائمة بأنواع استلام الطلب المتاحة
عمليات التعداد | |
---|---|
UNSPECIFIED |
نوع الاستلام غير محدّد. |
INSTORE |
يمكنك استلام الطعام من داخل المطعم. |
CURBSIDE |
ركن السيارة في مكان مخصص خارج المطعم ويقوم شخص ما بتوصيل الطعام هناك. |
CurbsideInfo
تفاصيل حول كيفية تسهيل الطلب من السيارة
تمثيل JSON | |
---|---|
{ "curbsideFulfillmentType": enum ( |
الحقول | |
---|---|
curbsideFulfillmentType |
يحتاج الشركاء إلى معلومات إضافية لتسهيل تنفيذ طلبات الاستلام من السيارة. بناءً على نوع التنفيذ الذي يتم اختياره، سيتم جمع التفاصيل المقابلة من المستخدم. |
userVehicle |
تفاصيل المركبة الخاصة بالمستخدم الذي يقدّم الطلب |
CurbsideFulfillmentType
القيم المحتملة لأنواع توصيل الطلبات إلى السيارة
عمليات التعداد | |
---|---|
UNSPECIFIED |
لم يتم تحديد نوع توصيل الطلب إلى السيارة. |
VEHICLE_DETAIL |
يجب توفير تفاصيل المركبة لتسهيل الاستلام من السيارة. |
مركبة
تفاصيل حول مركبة
تمثيل JSON | |
---|---|
{
"make": string,
"model": string,
"licensePlate": string,
"colorName": string,
"image": {
object ( |
الحقول | |
---|---|
make |
نوع المركبة (على سبيل المثال "Honda"). يتم عرض هذا الاسم للمستخدم ويجب ترجمته. مطلوبة. |
model |
طراز المركبة (على سبيل المثال "Grom"). يتم عرض هذا الاسم للمستخدم ويجب ترجمته. مطلوبة. |
licensePlate |
رقم لوحة ترخيص المركبة (مثلاً "1ABC234"). مطلوبة. |
colorName |
اسم لون المركبة، على سبيل المثال الأسود (اختياري) |
image |
عنوان URL يؤدي إلى صورة للمركبة سيتم عرض الصورة بحجم 256x256 بكسل تقريبًا. يجب أن يكون بتنسيق jpg أو png. اختياريّ. |
CheckInInfo
البيانات الوصفية التي يطلبها الشريك لإتاحة وسيلة تسجيل الوصول
تمثيل JSON | |
---|---|
{
"checkInType": enum ( |
الحقول | |
---|---|
checkInType |
هي الطريقة المستخدَمة لإرسال تعليمات تسجيل الوصول. |
CheckInType
تم استخدام طرق مختلفة لإرسال تعليمات تسجيل الوصول.
عمليات التعداد | |
---|---|
CHECK_IN_TYPE_UNSPECIFIED |
قيمة غير معروفة. |
EMAIL |
سيتم إرسال معلومات تسجيل الوصول عبر البريد الإلكتروني. |
SMS |
سيتم إرسال معلومات تسجيل الوصول عبر الرسائل القصيرة SMS. |
ItemOption
يمثل الإضافات أو العناصر الفرعية.
تمثيل JSON | |
---|---|
{ "id": string, "name": string, "prices": [ { object ( |
الحقول | |
---|---|
id |
بالنسبة إلى خيارات العناصر، معرّف السلعة الفريد. |
name |
اسم الخيار. |
prices[] |
السعر الإجمالي للخيار. |
note |
ملاحظة ذات صلة بالخيار |
quantity |
بالنسبة إلى الخيارات التي تتمثل في العناصر والكمية. |
productId |
معرّف المنتج أو العرض المرتبط بهذا الخيار. |
subOptions[] |
لتحديد خيارات فرعية متداخلة أخرى. |
ProductDetails
تفاصيل عن المنتج.
تمثيل JSON | |
---|---|
{ "productId": string, "gtin": string, "plu": string, "productType": string, "productAttributes": { string: string, ... } } |
الحقول | |
---|---|
productId |
معرّف المنتج أو العرض المرتبط بهذا العنصر. |
gtin |
تمثّل هذه السمة الرقم التجاري العالمي للسلعة. يكون هذا الإجراء مفيدًا إذا لم يتوفّر معرّف العرض في Merchant Center. اختياريّ. |
plu |
رموز البحث عن الأسعار، والمعروفة عادةً برموز PLU، أو أرقام PLU، أو PLU، أو رموز المنتجات، أو ملصقات المنتجات، هي نظام من الأرقام التي تحدّد بشكل فريد المنتجات المجمّعة التي يتم بيعها في متاجر البقالة ومحلات السوبرماركت. |
productType |
فئة المنتج التي حدّدها التاجر. على سبيل المثال: "الصفحة الرئيسية > البقالة > منتجات الألبان والبيض > الحليب > الحليب الكامل" |
productAttributes |
التفاصيل التي يقدّمها التاجر حول المنتج، مثل { "allergen": "peanut" }. تكون هذه المعلومات مفيدة إذا لم يكن OfferId متوفّرًا في Merchant Center. اختياريّ. عنصر يحتوي على قائمة من أزواج |
ReservationItemExtension
محتويات البند الخاصة بالطلبات المحجوزة مثل المطعم وقص الشعر. رقم التعريف التالي: 15.
تمثيل JSON | |
---|---|
{ "status": enum ( |
الحقول | |
---|---|
status |
مطلوب: حالة الحجز. |
userVisibleStatusLabel |
مطلوب: تصنيف/سلسلة مرئية للمستخدم للحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا. |
type |
نوع الحجز يمكن إلغاء ضبط هذا الإعداد في حال عدم انطباق أي من خيارات النوع. |
reservationTime |
الوقت الذي تمت جدولة الخدمة/الحدث فيه. يمكن أن يتمثل في نطاق زمني أو تاريخ أو وقت محدّد. |
userAcceptableTimeRange |
النطاق الزمني المقبول للمستخدم. |
confirmationCode |
رمز تأكيد هذا الحجز |
partySize |
عدد الأشخاص. |
staffFacilitators[] |
الموظفون المسؤولون عن الحجز. مثال مصفف الشعر. |
location |
الموقع الجغرافي للخدمة/الحدث |
extension |
أي حقول إضافية يتم تبادلها بين التاجر وGoogle. كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
ReservationStatus
حالة الحجز
عمليات التعداد | |
---|---|
RESERVATION_STATUS_UNSPECIFIED |
حالة غير محدّدة |
PENDING |
الحجز في انتظار المراجعة. |
CONFIRMED |
تم تأكيد الحجز. |
CANCELLED |
إلغاء الحجز من قِبل المستخدم |
FULFILLED |
تم الحجز. |
CHANGE_REQUESTED |
مطلوب تغيير الحجز |
REJECTED |
انتهت صلاحية الحجز أو تمّ رفضه من قِبل شركة الدمج. |
ReservationType
نوع الحجز
عمليات التعداد | |
---|---|
RESERVATION_TYPE_UNSPECIFIED |
نوع غير محدَّد. |
RESTAURANT |
حجز في مطعم |
HAIRDRESSER |
حجز لمصفف شعر. |
StaffFacilitator
معلومات حول مقدِّم الخدمة.
تمثيل JSON | |
---|---|
{
"name": string,
"image": {
object ( |
الحقول | |
---|---|
name |
تمثّل هذه السمة اسم مُنسّق الموظفين. مثال "سَمِيرْ عَادِلْ" |
image |
صور المؤدي |
PaymentData
بيانات الدفع المرتبطة بطلب معيّن
تمثيل JSON | |
---|---|
{ "paymentResult": { object ( |
الحقول | |
---|---|
paymentResult |
نتيجة الدفع التي تستخدمها شركة الدمج لإكمال معاملة. ستتم تعبئة هذا الحقل بواسطة "المهام مع مساعد Google" إذا كانت تجربة الدفع مُدارة من قِبل "المهام مع مساعد Google". |
paymentInfo |
معلومات الدفع المتعلقة بالطلب والتي تكون مفيدة للتفاعل المباشر مع المستخدم. |
PaymentResult
نتيجة الدفع المستخدَمة من قِبل الشركة المسؤولة عن عملية الدمج لإكمال معاملة
تمثيل JSON | |
---|---|
{ // Union field |
الحقول | ||
---|---|---|
حقل الاتحاد result يتم توفير بيانات الدفع على Google أو طريقة الدفع الخاصة بالتاجر. يمكن أن تكون السمة "result " واحدة فقط مما يلي: |
||
googlePaymentData |
بيانات طريقة الدفع التي قدّمتها Google. إذا كان معالج الدفع الذي تتعامل معه مُدرجًا كجهة لمعالجة الدفع المتوافقة مع Google هنا: https://developers.google.com/pay/api/ انتقِل إلى الجهة المسؤولة عن معالجة المعاملات من خلال الرابط للاطّلاع على المزيد من التفاصيل. ويمكنك أيضًا الاطّلاع على المستندات التالية للحصول على تفاصيل عن حمولة البيانات. https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
طريقة الدفع التي اختارها المستخدم من قِبل التاجر/الإجراء |
PaymentInfo
معلومات الدفع المتعلقة بالطلب الذي يتم تقديمه. يلتقط هذا النموذج الأوّلي معلومات مفيدة للتفاعل الموجه للمستخدم.
تمثيل JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
الحقول | |
---|---|
paymentMethodDisplayInfo |
المعلومات المعروضة لطريقة الدفع المُستخدَمة في المعاملة |
paymentMethodProvenance |
إثبات ملكية طريقة الدفع المُستخدَمة في المعاملة من المحتمل أن يكون المستخدم قد سجّل طريقة الدفع نفسها لدى كل من Google والتاجر. |
PaymentMethodDisplayInfo
نتيجة الدفع المستخدَمة من قِبل الشركة المسؤولة عن عملية الدمج لإكمال معاملة
تمثيل JSON | |
---|---|
{
"paymentType": enum ( |
الحقول | |
---|---|
paymentType |
نوع الدفعة. |
paymentMethodDisplayName |
اسم طريقة الدفع المعروض للمستخدم على سبيل المثال، VISA **** 1234 الحساب الجاري **** 5678 |
paymentMethodVoiceName |
اسم طريقة الدفع التي سيتم نطقها للمستخدم في الأجهزة المزوّدة بخدمة "مساعد 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 |
مطلوب: رمز القسيمة الذي تم تطبيقه على هذا العرض. |
PurchaseOrderExtension
إضافة الطلب لمجال الشراء تنطبق هذه السمات على جميع العناصر داخل الطلب، ما لم يتم إلغاؤها في عنصر واحد.
تمثيل JSON | |
---|---|
{ "status": enum ( |
الحقول | |
---|---|
status |
الحالة المطلوبة: الحالة العامة للطلب |
userVisibleStatusLabel |
تصنيف/سلسلة مرئية للمستخدم للحالة الحد الأقصى المسموح به للطول هو 50 حرفًا. |
type |
مطلوب: نوع الشراء |
returnsInfo |
معلومات الإرجاع الخاصة بالطلب |
fulfillmentInfo |
معلومات توصيل الطلب |
extension |
أي حقول إضافية يتم تبادلها بين التاجر وGoogle. كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |
purchaseLocationType |
الموقع الجغرافي الذي تم فيه إجراء عملية الشراء (في المتجر / على الإنترنت) |
errors[] |
اختياري: أخطاء تم بسبب رفض هذا الطلب بسببها |
PurchaseLocationType
نوع الموقع الجغرافي الذي تم فيه الشراء
عمليات التعداد | |
---|---|
UNSPECIFIED_LOCATION |
قيمة غير معروفة. |
ONLINE_PURCHASE |
جميع عمليات الشراء التي تم شراؤها على الإنترنت. |
INSTORE_PURCHASE |
جميع عمليات الشراء في المتجر |
PurchaseError
الأخطاء التي يمكن رفض طلب الشراء بسببها.
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | |
---|---|
type |
مطلوب: يشير ذلك إلى السبب الدقيق لرفض التاجر الطلب. |
description |
وصف إضافي للخطأ. |
entityId |
معرّف الكيان الذي يتوافق مع الخطأ. على سبيل المثال، يمكن أن يتوافق ذلك مع LineItemId / ItemOptionId. |
updatedPrice |
تكون هذه السمة مناسبة في حالة حدوث نوع خطأ PRICE_CHANGED / INCORRECT_PRICE. |
availableQuantity |
الكمية المتاحة الآن سارٍ في حالة 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
يمثل حدثًا واحدًا.
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | |
---|---|
type |
مطلوب: نوع حدث التذكرة، مثل فيلم أو حفلة موسيقية |
name |
مطلوب: اسم الحدث على سبيل المثال، إذا كان الحدث عبارة عن فيلم، يجب أن يكون هذا هو اسم الفيلم. |
description |
تمثّل هذه السمة وصف الفعالية. |
url |
عنوان URL لمعلومات الحدث. |
location |
الموقع الذي يُقام فيه الحدث، أو الموقع الذي تقع فيه المؤسسة. |
eventCharacters[] |
الأحرف المرتبطة بهذا الحدث يمكن أن يكونوا مخرجين أو ممثلين في حدث سينمائي أو مؤدّي حفلة موسيقية، وما إلى ذلك. |
startDate |
وقت البدء |
endDate |
وقت الانتهاء |
doorTime |
وقت الدخول الذي قد يختلف عن وقت بدء الحدث، مثلاً يبدأ الحدث في الساعة 9 صباحًا، في حين أنّ وقت المشاركة هو 8:30 صباحًا |
Type
نوع الحدث.
عمليات التعداد | |
---|---|
EVENT_TYPE_UNKNOWN |
نوع الحدث غير معروف. |
MOVIE |
فيلم. |
CONCERT |
حفلة موسيقية |
SPORTS |
الرياضة |
EventCharacter
هناك حرف حدث واحد، مثل المنظِّم والمنفِّذ وما إلى ذلك.
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع الشخصية في الحدث، مثل ممثل أو مخرج |
name |
اسم الشخصية |
image |
صور الشخصيات. |
Type
نوع الحرف
عمليات التعداد | |
---|---|
TYPE_UNKNOWN |
نوع غير معروف. |
ACTOR |
الممثل |
PERFORMER |
المؤدي. |
DIRECTOR |
المخرِج |
ORGANIZER |
المنظم. |