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)

طلب التذكرة

المحتويات

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

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

object (LineItem)

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

PaymentData

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

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

object (PaymentResult)

نتيجة الدفع التي تستخدمها شركة الدمج لإكمال معاملة ستتم تعبئة هذا الحقل بالإجراءات على Google إذا كانت تجربة الدفع مُدارة من خلال actions-on-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
}
الحقول
paymentType

enum (PaymentType)

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

string

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

الترويج

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

تمثيل 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)

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

PurchaseError

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

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

enum (ErrorType)

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

string

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

string

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

object (PriceAttribute)

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

integer

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

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 صباحًا.

EventCharacter

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

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

enum (Type)

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

string

اسم الشخصية.
image

object (Image)

صور الشخصية.