Method: mediaPlanners.search

חיפוש חשבונות של Media Planner שתואמים למזהה המושב הנתון ב-DSP.

בקשת HTTP

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

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

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

פרמטרים
dspSeatId

string

חובה. מזהה המושב ב-DSP שרוצים לחפש. מזהה המושב ב-DSP מסופק על ידי ה-Media Planner.
pageSize

integer

אופציונלי. המספר המקסימלי של תוכניות מדיה שיוחזרו. אם לא מציינים ערך, יוחזרו עד 100 תוכניות מדיה. הערך המקסימלי הוא 500. ערכים גבוהים יותר יומרו ל-500.
pageToken

string

אופציונלי. אסימון שמזהה את דף התוצאות שהשרת צריך להחזיר. הערך הזה מתקבל מקריאה קודמת של mediaPlanners.search ב-SearchMediaPlannersResponse.nextPageToken.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

תגובה שמכילה מידע על חשבון Media Planner מחיפוש.

אם הפעולה בוצעה בהצלחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "mediaPlanners": [
    {
      object (MediaPlanner)
    }
  ],
  "nextPageToken": string
}
שדות
mediaPlanners[]

object (MediaPlanner)

רשימה של תוכניות מדיה שתואמות לקריטריונים של החיפוש.
nextPageToken

string

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

היקפי הרשאות

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

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