- تمثيل 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 المقدَّمة أو أي قيمة فريدة أخرى. يُرجى العلم أنّ رقم التعريف المعروض للمستخدمين هو 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 |
طلب التذكرة |
الفهرس
برنامج تغليف العناصر.
تمثيل JSON | |
---|---|
{
"lineItems": [
{
object ( |
الحقول | |
---|---|
lineItems[] |
قائمة عناصر الطلب. يجب إدخال عنصر واحد على الأقل و50 عنصرًا كحدّ أقصى. يجب أن تنتمي جميع البنود إلى المجال نفسه. |
PaymentData
بيانات الدفع المرتبطة بطلب معيّن
تمثيل JSON | |
---|---|
{ "paymentResult": { object ( |
الحقول | |
---|---|
paymentResult |
نتيجة الدفع التي تستخدمها شركة الدمج لإكمال معاملة. ستتم تعبئة هذا الحقل بواسطة actions على 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 الحساب الجاري **** 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 |
صور الشخصيات. |