Method: sellers.availabilityOrders.list

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

  • برای مثال GET /v1/sellers/321/availabilityOrders
  • فهرستی از سفارش‌های موجود و یک رمز برای بازیابی صفحه بعدی در صورت موفقیت‌آمیز را برمی‌گرداند.
  • اگر کاربر به فروشنده دسترسی نداشته باشد یا شناسه فروشنده وجود نداشته باشد، کد خطا PERMISSION_DENIED را برمی گرداند.
  • اگر فروشندگان اندازه صفحه یا نشانه صفحه نامعتبر ارائه دهند، کد خطا را INVALID_ARGUMENT برمی گرداند.

درخواست HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/availabilityOrders

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
parent

string

مورد نیاز. والدین که این مجموعه سفارشات در دسترس را دارد. قالب: فروشندگان/{فروشنده}

پارامترهای پرس و جو

پارامترها
pageSize

integer

حداکثر تعداد اقلام برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند. حداکثر تعداد مجاز سفارشات در دسترس 1000 است. در صورت نامشخص بودن، حداکثر 1000 سفارش در دسترس برگشت داده می شود.

pageToken

string

مقدار nextPageToken از یک درخواست لیست قبلی، در صورت وجود، برگردانده شده است.

filter

string

فیلتر لیست در حال حاضر از فیلتر حالت پشتیبانی می کند، با نحو: "state = [STATE]". عملگرهای منطقی AND و OR را می توان برای زنجیره زدن فیلترها استفاده کرد.

orderBy

string

ترتیب رشته ای که برای تعیین ترتیب مرتب سازی نتایج استفاده می شود. در حال حاضر از سفارش‌دهی براساس updateTime پشتیبانی می‌کند، «updateTime» را برای مرتب‌سازی نتایج بر اساس updateTime به ترتیب صعودی یا «updateTime desc» برای ترتیب نزولی ارائه دهید.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "availabilityOrders": [
    {
      object (AvailabilityOrder)
    }
  ],
  "nextPageToken": string
}
فیلدها
availabilityOrders[]

object ( AvailabilityOrder )

لیست سفارشات موجود

nextPageToken

string

نشانه ای برای بازیابی صفحه بعدی نتایج. این مقدار را در قسمت pageToken در فراخوانی بعدی به روش availabilityOrders.list ارسال کنید تا صفحه بعدی نتایج را بازیابی کنید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/doubleclickbidmanager

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.