Method: mediaPlanners.list

호출자가 액세스할 수 있는 모든 미디어 플래너 계정을 나열합니다.

큐레이터의 경우 큐레이터 약관에 동의한 모든 미디어 기획자가 반환됩니다.

다른 계정의 경우 미디어 기획자를 나열하려고 하면 오류가 반환됩니다.

HTTP 요청

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

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

쿼리 매개변수

매개변수
pageSize

integer

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

pageToken

string

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

filter

string

Cloud API 목록 필터링 문법을 사용하는 선택적 쿼리 문자열입니다. 필터링에 지원되는 열은 다음과 같습니다.

  • name
  • displayName
  • ancestorNames

요청 본문

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

응답 본문

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

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

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

object (MediaPlanner)

미디어 기획자 목록입니다.

nextPageToken

string

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

승인 범위

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

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