Method: mediaPlanners.search

搜尋與指定需求端平台帳戶 ID 相符的媒體企劃人員帳戶。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
dspSeatId

string

必填。要搜尋的需求端平台帳戶 ID。需求端平台帳戶 ID 由媒體企劃人員提供。
pageSize

integer

(選用步驟) 要傳回的媒體企劃書數量上限。如未指定，最多會傳回 100 位媒體企劃人員。許可的最大值為 500；超出的數值將一律指定為 500。
pageToken

string

(選用步驟) 用來識別伺服器應傳回哪一頁結果的權杖。這個值是從 SearchMediaPlannersResponse.nextPageToken 中先前的 mediaPlanners.search 呼叫接收。

要求主體

要求主體必須為空白。

回應主體

包含搜尋結果中媒體企劃人員帳戶資訊的回覆。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "mediaPlanners": [
    {
      object (MediaPlanner)
    }
  ],
  "nextPageToken": string
}
欄位
mediaPlanners[]

object (MediaPlanner)

符合搜尋條件的媒體企劃人員清單。
nextPageToken

string

可傳遞至後續呼叫 mediaPlanners.search 方法的權杖，用於擷取 SearchMediaPlannersRequest.page_token 中的下一頁結果。

授權範圍

需要下列 OAuth 範圍：

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