Method: exchanges.auctionPackages.list

بسته های حراج را لیست می کند.

درخواست HTTP

GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/auctionPackages

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

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

پارامترها
parent

string

نام منبع والد مثال: «مبادلات/123». مورد نیاز.

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

پارامترها
pageSize

integer

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

pageToken

string

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

filter

string

اجازه می دهد تا فیلتر بر اساس خواص.

نحو پشتیبانی شده:

  • عبارات فیلتر از یک یا چند محدودیت تشکیل شده اند.
  • محدودیت ها را می توان با عملگرهای منطقی AND یا OR ترکیب کرد. دنباله ای از محدودیت ها به طور ضمنی از AND استفاده می کند.
  • یک محدودیت به شکل <field> <operator> <value> است.
  • عملگر باید EQUALS (=) باشد.
  • فیلدهای پشتیبانی شده در حال حاضر:
    • externalDealId

مثال ها:

  • بسته‌های حراج را با externalDealId تنظیم شده روی "package-1234" externalDealId="package-1234" دریافت کنید

طول این فیلد نباید بیشتر از 500 کاراکتر باشد.

درخواست بدن

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

بدن پاسخگو

پاسخ به بسته های حراج لیست.

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

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

object ( AuctionPackage )

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

nextPageToken

string

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .