Method: exchanges.auctionPackages.list

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
parent

string

الزامی. نام منبع والد. مثال: exchanges/123 .

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

پارامترها
pageSize

integer

اختیاری. حداکثر تعداد آیتم‌هایی که باید برگردانده شوند. حداکثر مقدار مجاز ۵۰ است. اگر مشخص نشود یا بیشتر از ۵۰ باشد، اندازه صفحه ۵۰ در نظر گرفته می‌شود.

pageToken

string

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

filter

string

اختیاری. امکان فیلتر کردن بر اساس ویژگی‌های بسته حراج را فراهم می‌کند.

سینتکس پشتیبانی شده:

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

مثال‌ها:

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

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

درخواست بدنه

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

بدنه پاسخ

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

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

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

object ( AuctionPackage )

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

nextPageToken

string

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

دامنه‌های مجوز

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

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

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

،

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
parent

string

الزامی. نام منبع والد. مثال: exchanges/123 .

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

پارامترها
pageSize

integer

اختیاری. حداکثر تعداد آیتم‌هایی که باید برگردانده شوند. حداکثر مقدار مجاز ۵۰ است. اگر مشخص نشود یا بیشتر از ۵۰ باشد، اندازه صفحه ۵۰ در نظر گرفته می‌شود.

pageToken

string

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

filter

string

اختیاری. امکان فیلتر کردن بر اساس ویژگی‌های بسته حراج را فراهم می‌کند.

سینتکس پشتیبانی شده:

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

مثال‌ها:

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

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

درخواست بدنه

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

بدنه پاسخ

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

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

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

object ( AuctionPackage )

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

nextPageToken

string

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

دامنه‌های مجوز

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

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

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

،

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
parent

string

الزامی. نام منبع والد. مثال: exchanges/123 .

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

پارامترها
pageSize

integer

اختیاری. حداکثر تعداد آیتم‌هایی که باید برگردانده شوند. حداکثر مقدار مجاز ۵۰ است. اگر مشخص نشود یا بیشتر از ۵۰ باشد، اندازه صفحه ۵۰ در نظر گرفته می‌شود.

pageToken

string

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

filter

string

اختیاری. امکان فیلتر کردن بر اساس ویژگی‌های بسته حراج را فراهم می‌کند.

سینتکس پشتیبانی شده:

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

مثال‌ها:

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

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

درخواست بدنه

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

بدنه پاسخ

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

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

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

object ( AuctionPackage )

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

nextPageToken

string

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

دامنه‌های مجوز

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

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

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