- تمثيل JSON
- جدول المحتويات
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- العروض الترويجية
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
كيان الطلب: ملاحظة: 1- يجب أن تكون كل السلاسل على جميع المستويات أقل من 1000 حرف ما لم يتم تحديد خلاف ذلك. 2. يجب أن يكون عدد جميع الحقول المتكرّرة على جميع المستويات أقل من 50، ما لم يتم تحديد خلاف ذلك. 3- يجب أن تكون كل الطوابع الزمنية بجميع المستويات، في حال تحديدها، طوابع زمنية صالحة.
تمثيل JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
الحقول | ||
---|---|---|
googleOrderId |
مُعرّف الطلب الذي قدمته Google. |
|
merchantOrderId |
مطلوب: مُعرّف الطلب الداخلي الذي عيّنه التاجر. ويجب أن يكون هذا المعرّف فريدًا ومطلوبًا للعمليات اللاحقة الخاصة بتعديل الطلب. قد يتم ضبط هذا المعرّف على googleOrderId المقدَّم أو أي قيمة فريدة أخرى. يُرجى العِلم أنّ المعرّف المقدَّم للمستخدمين هو userVisualOrderId، والذي قد يكون قيمة مختلفة وأكثر سهولة في الاستخدام. الحد الأقصى المسموح به للطول هو 128 حرفًا. |
|
userVisibleOrderId |
رقم التعريف الموجَّه للمستخدم الذي يشير إلى الطلب الحالي يجب أن يكون هذا المعرّف متوافقًا مع المعرّف المعروض لهذا الطلب في السياقات الأخرى، بما في ذلك المواقع الإلكترونية والتطبيقات والبريد الإلكتروني. |
|
userVisibleStateLabel |
متوقّفة نهائيًا: استخدِم حالة إضافات الطلب بدلاً منها. تصنيف مرئي للمستخدم للحالة التي تم فيها تقديم هذا الطلب |
|
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 |
طلب التذكرة |
المحتويات
ملف تغليف العناصر
تمثيل JSON | |
---|---|
{
"lineItems": [
{
object ( |
الحقول | |
---|---|
lineItems[] |
قائمة عناصر الطلب ويجب توفير عنصر واحد على الأقل، ويُسمح باستخدام 50 عنصرًا كحد أقصى. يجب أن تنتمي كل العناصر إلى موضع الإعلان نفسه. |
PaymentData
بيانات الدفع المرتبطة بطلب معيّن
تمثيل JSON | |
---|---|
{ "paymentResult": { object ( |
الحقول | |
---|---|
paymentResult |
نتيجة الدفع التي تستخدمها شركة الدمج لإكمال معاملة ستتم تعبئة هذا الحقل بالإجراءات على Google إذا كانت تجربة الدفع مُدارة من خلال actions-on-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 Checkout acct **** 5678 |
الترويج
العروض الترويجية أو العروض التي تمّت إضافتها إلى سلة التسوّق
تمثيل JSON | |
---|---|
{ "coupon": string } |
الحقول | |
---|---|
coupon |
مطلوب: رمز القسيمة المطبَّق على هذا العرض. |
PurchaseOrderExtension
إضافة الطلب لقطاع الشراء. تنطبق هذه السمات على جميع تفاصيل الطلب داخل الطلب، ما لم يتم إلغاؤها في عنصر.
تمثيل JSON | |
---|---|
{ "status": enum ( |
الحقول | |
---|---|
status |
مطلوب: الحالة العامة للطلب |
userVisibleStatusLabel |
إظهار المستخدم للتصنيف/السلسلة للحالة. الحد الأقصى المسموح به للطول هو 50 حرفًا. |
type |
مطلوب: نوع الشراء. |
returnsInfo |
إرجاع معلومات الطلب |
fulfillmentInfo |
معلومات توصيل الطلب |
extension |
أي حقول إضافية يتم تبادلها بين التاجر وGoogle كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي |
purchaseLocationType |
موقع عملية الشراء (في المتجر / على الإنترنت) |
errors[] |
اختياري: الأخطاء التي أدّت إلى رفض هذا الطلب. |
PurchaseError
الأخطاء التي يمكن أن يتم رفض طلب الشراء بسببها
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | |
---|---|
type |
مطلوب: يمثّل هذا الحقل السبب الدقيق لرفض التاجر للطلب. |
description |
وصف إضافي للخطأ. |
entityId |
رقم تعريف الكيان الذي يتوافق مع الخطأ. مثال: يمكن أن تتوافق هذه القيمة مع LineItemId / ItemOptionId. |
updatedPrice |
هذه السمة مفيدة في حال نوع الخطأ PRICE_CHANGED / INCORRECT_PRICE. |
availableQuantity |
الكمية متوفرة الآن. سارٍ في حال AVAILABILITY_CHANGED. |
TicketOrderExtension
اطلب محتوى طلبات التذاكر، مثل الأفلام والفعاليات الرياضية وغيرها.
تمثيل JSON | |
---|---|
{
"ticketEvent": {
object ( |
الحقول | |
---|---|
ticketEvent |
تم تطبيق الحدث على جميع تذاكر تفاصيل الإعلان. |
TicketEvent
ويمثل حدثًا واحدًا.
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | |
---|---|
type |
مطلوب: نوع حدث التذكرة، على سبيل المثال أو فيلم أو حفلة موسيقية. |
name |
مطلوب: اسم الفعالية. على سبيل المثال، إذا كان الحدث عبارة عن فيلم، يجب أن يكون هذا اسم الفيلم. |
description |
وصف الحدث. |
url |
عنوان URL لمعلومات الفعالية. |
location |
تمثّل هذه السمة الموقع الجغرافي الذي ستقام فيه الفعالية أو المؤسسة. |
eventCharacters[] |
تمثّل هذه السمة الشخصيات ذات الصلة بهذا الحدث. يمكن أن يكونوا مخرجين أو ممثلين لحدث فيلم، أو مقدمو حفلة موسيقية، وما إلى ذلك. |
startDate |
وقت البدء |
endDate |
وقت الانتهاء |
doorTime |
وقت الإدخال، الذي قد يختلف عن وقت بدء الحدث مثلاً: يبدأ الحدث في الساعة 9 صباحًا، ولكن وقت الدخول هو 8:30 صباحًا. |
EventCharacter
حرف حدث واحد، مثل المنظّم أو المؤدي وما إلى ذلك
تمثيل JSON | |
---|---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع حرف الحدث، على سبيل المثال ممثل أو مخرج. |
name |
اسم الشخصية. |
image |
صور الشخصية. |