Method: mediaPlanners.list

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

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

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

HTTP 요청

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

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

쿼리 매개변수

매개변수
pageSize

integer

반환할 미디어 플래너의 최대 개수입니다. 지정하지 않으면 최대 100개의 미디어 플래너가 반환됩니다. 최댓값은 500이며, 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

ListMediaPlannersRequest.page_token에서 결과의 다음 페이지를 검색하기 위해 mediaPlanners.list 메서드에 대한 후속 호출에 전달될 수 있는 토큰입니다.

승인 범위

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

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

MediaPlanner

미디어 플래너 계정을 나타냅니다.

JSON 표현 
{
  "accountId": string,
  "name": string,
  "displayName": string,
  "ancestorNames": [
    string
  ]
}
필드
accountId
(deprecated)

string

출력 전용입니다. 미디어 플래너의 계정 ID입니다.
name

string

식별자. 미디어 플래너의 고유 리소스 이름입니다. 형식은 mediaPlanners/{mediaPlannerAccountId}입니다. mediaPlanners.list 메서드의 응답을 필터링하는 데 사용할 수 있습니다.
displayName

string

출력 전용입니다. 미디어 플래너의 표시 이름입니다. [mediaPlanners.list][google.ads.authorizedbuyers.marketplace.v1main.MediaPlanners.ListMediaPlanners] 메서드의 응답을 필터링하는 데 사용할 수 있습니다.
ancestorNames[]

string

출력 전용입니다. 미디어 플래너의 상위 이름입니다. 형식은 mediaPlanners/{mediaPlannerAccountId}입니다. mediaPlanners.list 메서드의 응답을 필터링하는 데 사용할 수 있습니다.