Method: mediaPlanners.search

지정된 DSP 시트 ID와 일치하는 미디어 기획자 계정을 검색합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

쿼리 매개변수

매개변수
dspSeatId

string

필수 항목입니다. 검색할 DSP 시트 ID입니다. DSP 시트 ID는 미디어 기획자가 제공합니다.

pageSize

integer

선택사항입니다. 반환할 미디어 기획자의 최대 수입니다. 지정하지 않으면 미디어 기획자가 최대 100명 반환됩니다. 최댓값은 500이며, 500을 초과하는 값은 500으로 변환됩니다.

pageToken

string

선택사항입니다. 서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 이 값은 SearchMediaPlannersResponse.nextPageToken의 이전 mediaPlanners.search 호출에서 수신됩니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

검색에서 미디어 기획자 계정 정보가 포함된 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "mediaPlanners": [
    {
      object (MediaPlanner)
    }
  ],
  "nextPageToken": string
}
필드
mediaPlanners[]

object (MediaPlanner)

검색 기준과 일치하는 미디어 기획자 목록입니다.

nextPageToken

string

SearchMediaPlannersRequest.page_token에서 다음 결과 페이지를 가져오기 위해 mediaPlanners.search 메서드에 대한 후속 호출에 전달할 수 있는 토큰입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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