REST Resource: orders

المورد: الطلب

الطلب هو مجموعة من Lines تحدّد حالات عرض الإعلانات ومواضع عرضها.

تمثيل JSON 
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "orderState": enum (OrderState),
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
الحقول
name

string

النتائج فقط. اسم مورد الطلب بالتنسيق: Orders/{id}`.
externalId

string

اختياريّ. رقم تعريف يتم استخدامه لربط هذا الكيان بمصادر خارجية.
displayName

string

النتائج فقط. تمثّل هذه السمة الاسم المعروض للطلب.

يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 240 بايت.
description

string

النتائج فقط. حقل إضافي حر لوصف الطلب
orderState

enum (OrderState)

النتائج فقط. يمثل الحالة المحسوبة للطلب بناءً على حالة أسطره.
createTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لإنشاء الطلب

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

النتائج فقط. آخر تعديل للطابع الزمني للطلب

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
advertiserInfo

object (AdvertiserInfo)

النتائج فقط. معلومات المعلِن

OrderState

حالة الطلب.

عمليات التعداد
ORDER_STATE_UNSPECIFIED القيمة التلقائية عندما لا يتم تحديد حالة الطلب أو عندما تكون غير معروفة في هذا الإصدار.
ORDER_STATE_PENDING_RESERVATION

يحتوي الطلب على:

  • سطر واحد أو أكثر في حالة الحجز المعلّق.
  • سطور صفرية أو أكثر في الحالة المحجوزة.
  • صفر أسطر في جميع الحالات الأخرى.
ORDER_STATE_RESERVED

يحتوي الطلب على:

  • لا توجد سطور في حالة الحجز المُعلّقة.
  • سطر واحد أو أكثر في حالة محجوزة.
  • عدم وجود أي سطور أو أكثر في حالة الرفض حسب حالة البائع
  • صفر أسطر في جميع الحالات الأخرى.
ORDER_STATE_PENDING_BOOKING

يحتوي الطلب على:

  • لا توجد سطور في حالة الحجز المُعلّقة.
  • لا يحتوي على أي أسطر في الحالة المحجوزة.
  • سطر واحد أو أكثر في حالة الحجز المعلَّقة.
  • عدم وجود أي سطور أو أكثر في حالة الرفض حسب حالة البائع
  • صفر أو أكثر من الأسطر التي ألغاها المشتري.
  • صفر أسطر في جميع الحالات الأخرى.
ORDER_STATE_BOOKED

يحتوي الطلب على:

  • لا توجد سطور في حالة الحجز المُعلّقة.
  • لا يحتوي على أي أسطر في الحالة المحجوزة.
  • لا تحتوي على أي أسطر في حالة الحجز المعلّقة.
  • سطر واحد أو أكثر في الحالة المحجوزة.
  • عدم وجود أي سطور أو أكثر في حالة الرفض حسب حالة البائع
  • صفر أو أكثر من الأسطر التي ألغاها المشتري.
  • صفر أسطر في جميع الحالات الأخرى.
ORDER_STATE_REJECTED_BY_SELLER

يحتوي الطلب على:

  • لا توجد سطور في حالة الحجز المُعلّقة.
  • لا يحتوي على أي أسطر في الحالة المحجوزة.
  • لا تحتوي على أي أسطر في حالة الحجز المعلّقة.
  • لا تحتوي على أي أسطر في الحالة المحجوزة.
  • سطر واحد أو أكثر في حالة رفض البائع له.
  • تم إلغاء أي سطر من الأسطر بواسطة المشتري.
  • صفر أسطر في جميع الحالات الأخرى.
ORDER_STATE_CANCELLED_BY_BUYER

يحتوي الطلب على:

  • لا توجد سطور في حالة الحجز المُعلّقة.
  • لا يحتوي على أي أسطر في الحالة المحجوزة.
  • لا تحتوي على أي أسطر في حالة الحجز المعلّقة.
  • لا تحتوي على أي أسطر في الحالة المحجوزة.
  • عدم وجود أي أسطر في حال رفضت حالة البائع
  • سطر واحد أو أكثر ملغاة من قبل المشتري.
  • صفر أسطر في جميع الحالات الأخرى.
ORDER_STATE_PENDING_RESERVATION_EXPIRED

يحتوي الطلب على:

  • انتهت صلاحية سطر واحد أو أكثر في الحجز المعلّق.
  • صفر أسطر في جميع الحالات الأخرى.
ORDER_STATE_RESERVED_EXPIRED

يحتوي الطلب على:

  • سطر واحد أو أكثر في العناوين المحجوزة.
  • صفر أسطر في جميع الحالات الأخرى.

الطُرق

get

 لاسترداد طلب فردي.

list

 يسرد الطلبات.

patch

 لتعديل طلب حالي