REST Resource: availabilityOrders

المورد: availabilityOrder

طلب مدى التوفّر هو مجموعة من AvailabilityLines. تم إنشاء طلب مدى التوفّر من قبل المشتري. يعدّل البائع مدى التوفّر مع الردّ.

في ما يلي خطوات سير العمل:

  • ينشئ المشتري أمر مدى التوفّر وأسطره ويضبط الولاية على الحالة "في انتظار المراجعة". لا يُسمح بإجراء المزيد من التغييرات على طلب مدى التوفّر أو السطر.
  • يتعامل البائع مع كل أسطر مدى التوفّر إما من خلال إكمالها مع تضمين بنود التوفّر أو وضع علامة "مرفوض". لا يمكن إكمال الإجراءات أو رفضها إلا عندما يكون الطلب والسطر في حالة الانتظار.
  • يستخدم البائع إجراء complete المخصّص لوضع علامة على طلب مدى التوفّر كمكتمل. لا يُسمح بإجراء المزيد من التغييرات على طلب مدى التوفّر أو الأسطر الفرعية بعد اكتمالها.
تمثيل JSON 
{
  "name": string,
  "description": string,
  "state": enum (State),
  "pendingExpirationTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
الحقول
name

string

النتائج فقط. تمثّل هذه السمة اسم المورد لطلب مدى التوفّر بالتنسيق: availabilityOrders/{id}.
description

string

النتائج فقط. حقل إضافي حر لوصف طلب مدى التوفّر
state

enum (State)

النتائج فقط. تمثّل هذه السمة حالة طلب مدى التوفّر هذا. يمكنك الانتقال إلى AvailabilityOrder.State للتعرّف على مراحل نشاط الطلب AvailabilityOrder.

يمكن للبائع استخدام طريقة Complete المخصّصة لضبطها على STATE_COMPLETED.
pendingExpirationTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لانتهاء صلاحية الطلب الذي في انتظار المراجعة لمدى التوفّر. على البائع إكمال الإجراء قبل انتهاء صلاحية طلب مدى التوفّر المعلَّق، وإلا سيتم التعامل مع الطلب على أنّه مكتمل بدون مدى التوفّر.

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

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

الحالة

القيم المحتملة لحالة طلب مدى التوفّر

عمليات التعداد
STATE_UNSPECIFIED تشير هذه السمة إلى القيمة التلقائية عندما لا يتم تحديد حالة طلب مدى التوفّر أو تكون غير معروفة في هذا الإصدار.
STATE_PENDING في انتظار مدى التوفّر عندما قدّم المشتري إعدادات طلب التوفّر.
STATE_COMPLETED تشير اكتمال عملية مدى التوفّر إلى الوقت الذي قدَّم فيه البائع ردًّا حول مدى التوفّر لجميع الخطوط.
STATE_CANCELLED تم إلغاء حالة التوفّر عندما قدّم المشتري طلب الإلغاء قبل أن يقدّم البائع ردّ مدى التوفّر لجميع الخطوط.
STATE_EXPIRED حالة مدى التوفّر انتهت صلاحيتها عندما انتهت صلاحية الطلب قبل أن يكمله البائع.

الطُرق

complete

 وضع علامة "مكتمل" على طلب مدى التوفّر الحالي

get

 لاسترداد طلب مدى التوفّر الفردي.

list

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