Method: sellers.availabilityOrders.availabilityLines.list

خطوط را برای سفارش در دسترس بودن فهرست می کند.

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

درخواست HTTP

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

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

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

پارامترها
parent

string

مورد نیاز. نام منبع والد قالب: sellers/{seller}/availabilityOrders/{availability_order}

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

پارامترها
pageSize

integer

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

pageToken

string

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

filter

string

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

orderBy

string

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

درخواست بدن

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

بدن پاسخگو

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

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

object ( AvailabilityLine )

لیست خطوط در دسترس بودن

nextPageToken

string

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

محدوده مجوز

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

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

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