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)

طلب التذكرة

الفهرس

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

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

object (LineItem)

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

PaymentData

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

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

object (PaymentResult)

نتيجة الدفع التي تستخدمها شركة الدمج لإكمال معاملة. ستتم تعبئة هذا الحقل بواسطة actions على 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 الحساب الجاري **** 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)

صور الشخصيات.