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 به AvailabilityOrder.State مراجعه کنید.

فروشنده می تواند از روش سفارشی Complete برای تنظیم STATE_COMPLETED استفاده کند.

pendingExpirationTime

string ( Timestamp format)

فقط خروجی مهر زمانی انقضا برای سفارش در دسترس بودن معلق. فروشنده باید قبل از منقضی شدن سفارش در دسترس بودن معلق آن را تکمیل کند، در غیر این صورت به عنوان کامل بدون در دسترس بودن تلقی می شود.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

createTime

string ( Timestamp format)

فقط خروجی مهر زمانی ایجاد توسط سیستم تعیین شده است.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

updateTime

string ( Timestamp format)

فقط خروجی آخرین مُهر زمانی به روز شده توسط سیستم تعیین شده است.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

advertiserInfo

object ( AdvertiserInfo )

فقط خروجی اطلاعات آگهی دهنده

ایالت

مقادیر ممکن برای وضعیت سفارش در دسترس بودن.

Enums
STATE_UNSPECIFIED مقدار پیش فرض زمانی که وضعیت سفارش در دسترس بودن در این نسخه مشخص نشده است یا ناشناخته است.
STATE_PENDING زمانی که خریدار تنظیمات درخواست در دسترس بودن را ارائه کرد، در دسترس بودن معلق است.
STATE_COMPLETED وضعیت در دسترس بودن کامل زمانی که فروشنده پاسخ در دسترس بودن را برای همه خطوط ارائه کرد.
STATE_CANCELLED وضعیت در دسترس بودن لغو شده زمانی که خریدار قبل از اینکه فروشنده پاسخ در دسترس بودن را برای همه خطوط ارائه دهد، درخواست لغو را ارائه کرد.
STATE_EXPIRED وضعیت در دسترس بودن منقضی شده زمانی که سفارش قبل از تکمیل فروشنده منقضی شود.

روش ها

complete

یک سفارش موجود در دسترس را به عنوان کامل علامت گذاری می کند.

get

یک سفارش در دسترس بودن فردی را بازیابی می کند.

list

سفارشات موجود را فهرست می کند.