Method: mediaPlanners.list

רשימה של כל החשבונות בכלי לתכנון המדיה שלמבצע הקריאה החוזרת (caller) יש גישה אליהם.

אם אתם אוצרים, תקבלו את כל הכלים לתכנון המדיה שאישרו את התנאים לאוצרים.

בחשבונות אחרים, ניסיון להציג את רשימת הכלים לתכנון מדיה יחזיר שגיאה.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של שאילתה

פרמטרים
pageSize

integer

המספר המקסימלי של תוכניות המדיה שיוחזרו. אם לא מציינים ערך, יוחזרו עד 100 תוכניות מדיה. הערך המקסימלי הוא 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

טוקן שאפשר להעביר לקריאה הבאה ל-method‏ mediaPlanners.list כדי לאחזר את דף התוצאות הבא ב-ListMediaPlannersRequest.page_token.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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