Method: sellers.adUnits.list

광고 단위를 나열합니다.

  • 예: GET /v1/sellers/seller111/adUnits
  • 성공하면 다음 페이지를 가져오기 위한 광고 단위 목록과 토큰을 반환합니다.
  • 사용자에게 판매자 액세스 권한이 없거나 판매자 ID가 없으면 오류 코드 PERMISSION_DENIED가 반환됩니다.
  • 판매자가 잘못된 페이지 크기나 페이지 토큰을 제공하면 오류 코드 INVALID_ARGUMENT를 반환합니다.

HTTP 요청

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 이 광고 단위 모음을 소유한 판매자입니다. 형식: sellers/{seller}

쿼리 매개변수

매개변수
pageSize

integer

반환할 최대 항목 수입니다. 서비스가 이 값보다 더 적게 반환할 수 있습니다. 광고 단위의 최대 허용 개수는 1,000개입니다. 1,000 이상의 값은 1,000으로 변경됩니다. 지정하지 않으면 최대 1, 000개의 광고 단위가 반환됩니다.
pageToken

string

이전 List 요청에서 반환된 nextPageToken 값입니다(있는 경우).
filter

string

목록 필터 현재 'externalId = [EXTERNAL_ID]' 문법과 함께 외부 ID 및 상태 필터링이 지원됩니다. 'state = [STATE]'입니다. 논리 연산자 AND 및 OR은 필터를 연결하는 데 사용할 수 있습니다. AD_UNIT_STATE_DELETED는 삭제된 광고 단위를 표시하는 데 사용할 수 없습니다. 대신 showRemove를 사용하세요.
orderBy

string

결과의 정렬 순서를 지정하는 데 사용되는 문자열 기준 정렬입니다. 현재 updateTime별 정렬을 지원합니다. 'updateTime'을 제공하세요. 'updateTime desc'를 사용하여 updateTime을 기준으로 오름차순으로 결과를 정렬합니다. 내림차순입니다.
showDeleted

boolean

소프트 삭제된 광고 단위를 반환할지 여부입니다.

요청 본문

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

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

InventoryService.ListAdUnits의 응답 메시지입니다.

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

object (AdUnit)

광고 단위의 목록입니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰입니다. 이후 adUnits.list 메서드 호출에서 pageToken 필드에 이 값을 전달하여 결과의 다음 페이지를 검색합니다.

승인 범위

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

  • https://www.googleapis.com/auth/doubleclickbidmanager

자세한 내용은 OAuth 2.0 개요를 참고하세요.