Method: mediaPlanners.list

همه حساب‌های طراح رسانه را که تماس‌گیرنده به آن‌ها دسترسی دارد فهرست می‌کند.

برای متصدیان، این کار همه طراحان رسانه را که شرایط متصدی را پذیرفته‌اند برمی‌گرداند.

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

درخواست HTTP

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

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

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

پارامترها
pageSize

integer

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

string

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

string

رشته پُرسمان اختیاری بااستفاده از نحو فیلتر کردن فهرست Cloud API. ستون‌های پشتیبانی‌شده برای فیلتر کردن عبارت‌اند از:

  • name
  • displayName
  • ancestorNames

متن درخواست

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

بدنه پاسخ

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

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

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

object (MediaPlanner)

فهرست طراحان رسانه.
nextPageToken

string

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

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

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

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