Method: exchanges.orders.list

ترتیب لیست ها

درخواست HTTP

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

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

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

پارامترها
parent

string

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

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

پارامترها
pageSize

integer

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

pageToken

string

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

filter

string

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

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

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

مثال ها:

  • دریافت سفارشات با وضعیت تنظیم شده روی "ACCEPTED" status=ACCEPTED

  • دریافت سفارش با نام نمایشی "نمایش نام" displayName="display name"

  • دریافت سفارش‌هایی با زمان به‌روزرسانی بیشتر از "2024-02-12T18:47:29.784Z" updateTime>"2024-02-12T18:47:29.784Z"

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

درخواست بدن

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

بدن پاسخگو

پاسخ به ترتیب لیست

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

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

object ( Order )

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

nextPageToken

string

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

محدوده مجوز

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

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

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