Method: mediaPlanners.search

حساب‌های طراح رسانه را که با شناسه جایگاه DSP داده‌شده مطابقت دارند جستجو می‌کند.

درخواست HTTP

GET https://curationpartners.googleapis.com/v1/mediaPlanners:search

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

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

پارامترها
dspSeatId

string

الزامی. شناسه جایگاه DSP برای جستجو. شناسه جایگاه DSP را طراح رسانه ارائه می‌کند.

pageSize

integer

اختیاری. حداکثر تعداد طراحان رسانه برای برگرداندن. اگر مشخص نشده باشد، حداکثر ۱۰۰ برنامه‌ریز رسانه برگردانده می‌شود. حداکثر مقدار ۵۰۰ است؛ مقادیر بالاتر از ۵۰۰ به ۵۰۰ تبدیل خواهند شد.

pageToken

string

اختیاری. نشانه‌ای که صفحه‌ای از نتایج را که سرور باید برگرداند شناسایی می‌کند. این مقدار از تماس قبلی mediaPlanners.search در SearchMediaPlannersResponse.nextPageToken دریافت شده است.

متن درخواست

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

بدنه پاسخ

پاسخی حاوی اطلاعات حساب طراح رسانه از جستجو.

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

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

object (MediaPlanner)

فهرست طراحان رسانه منطبق با معیارهای جستجو.

nextPageToken

string

نشانه‌ای که می‌تواند به تماس بعدی با روش mediaPlanners.search ارسال شود تا صفحه بعدی نتایج در SearchMediaPlannersRequest.page_token بازیابی شود.

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

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

  • https://www.googleapis.com/auth/curation-partners