Method: mediaPlanners.list

تعرض هذه الطريقة جميع حسابات مخطّط الوسائط التي يمكن للمتصل الوصول إليها.

بالنسبة إلى القيّمين، ستعرض هذه الطريقة جميع مخطّطات الوسائط التي قبلت بنود القيّمين.

بالنسبة إلى الحسابات الأخرى، ستعرض محاولة إدراج مخطّطات الوسائط خطأً.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

معامِلات طلب البحث

المعلمات
pageSize

integer

الحد الأقصى لعدد مخطّطات الوسائط المطلوب عرضها. إذا لم يتم تحديد هذا الحقل، سيتم عرض 100 مخطّط وسائط على الأكثر. الحد الأقصى للقيمة هو 500، وسيتم فرض القيمة 500 على القيم التي تزيد عن 500.
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

MediaPlanner

يمثّل حساب مخطّط وسائط.

تمثيل JSON 
{
  "accountId": string,
  "name": string,
  "displayName": string,
  "ancestorNames": [
    string
  ]
}
الحقول
accountId
(deprecated)

string

النتائج فقط. رقم تعريف حساب مخطّط الوسائط
name

string

المعرّف. اسم المورد الفريد لمخطّط الوسائط التنسيق: mediaPlanners/{mediaPlannerAccountId} يمكن استخدامه لفلترة استجابة الطريقة mediaPlanners.list
displayName

string

النتائج فقط. الاسم المعروض لمخطّط الوسائط يمكن استخدامه لفلترة استجابة طريقة [mediaPlanners.list][google.ads.authorizedbuyers.marketplace.v1main.MediaPlanners.ListMediaPlanners]
ancestorNames[]

string

النتائج فقط. أسماء العناصر الرئيسية لمخطّط الوسائط التنسيق: mediaPlanners/{mediaPlannerAccountId} يمكن استخدامه لفلترة استجابة الطريقة mediaPlanners.list