Method: exchanges.publishers.list

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

درخواست HTTP

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

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

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

پارامترها
parent

string

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

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

پارامترها
pageSize

integer

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

pageToken

string

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

filter

string

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

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

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

مثال ها:

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

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

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

درخواست بدن

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

بدن پاسخگو

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

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

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

object ( Publisher )

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

nextPageToken

string

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

محدوده مجوز

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

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

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