- HTTP 요청
- 요청 본문
- 응답 본문
- 승인 범위
- ProductMetadata
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- PlannableTargeting
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- YouTubeSelectLineUp
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- SurfaceTargetingCombinations
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
허용된 타겟팅을 사용하여 위치별로 계획 가능한 YouTube 광고 형식의 목록을 반환합니다.
발생한 오류 목록: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError
HTTP 요청
POST https://googleads.googleapis.com/v17:listPlannableProducts
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "plannableLocationId": string } |
필드 | |
---|---|
plannableLocationId |
필수 항목입니다. 계획을 위해 선택한 위치의 ID입니다. 사용 가능한 계획 가능한 위치 ID를 나열하려면 |
응답 본문
사용 가능한 모든 제품이 포함된 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"productMetadata": [
{
object ( |
필드 | |
---|---|
productMetadata[] |
계획 및 관련 타겟팅 메타데이터에 사용할 수 있는 제품 목록 |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
ProductMetadata
사용 가능한 계획 가능한 제품과 관련된 메타데이터입니다.
JSON 표현 |
---|
{
"plannableProductName": string,
"plannableTargeting": {
object ( |
필드 | |
---|---|
plannableProductName |
광고상품과 연결된 이름입니다. |
plannableTargeting |
이 제품에 허용되는 계획 가능한 타겟팅입니다. |
plannableProductCode |
광고상품과 연결된 코드입니다 (예: BUMPER, TRUEVIEW_IN_STREAM). 사용 가능한 계획 가능한 제품 코드를 나열하려면 |
PlannableTargeting
트래픽 측정항목이 보고될 타겟팅입니다.
JSON 표현 |
---|
{ "ageRanges": [ enum ( |
필드 | |
---|---|
ageRanges[] |
측정항목이 보고되는 제품의 계획 가능한 연령대입니다. 실제 타겟팅은 이 연령대를 표준 Google common.AgeRangeInfo 값에 매핑하여 계산됩니다. |
genders[] |
광고상품에 대해 타겟팅할 수 있는 성별입니다. |
devices[] |
광고 제품에 대해 타겟팅할 수 있는 기기입니다. CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER, GOOGLE_PREFERRED_SHORT 제품에 모바일 타겟팅이 선택된 경우 TABLET 기기 타겟팅이 보고된 측정항목에 자동으로 적용됩니다. |
networks[] |
광고 제품에 대해 타겟팅할 수 있는 네트워크입니다. |
youtubeSelectLineups[] |
광고 제품에 대해 타겟팅할 수 있는 YouTube Select 라인업입니다. |
surfaceTargeting |
광고 상품의 타겟팅 가능한 표시 경로 조합입니다. |
YouTubeSelectLineUp
제품 타겟팅을 위한 Plannable YouTube Select 라인업
JSON 표현 |
---|
{ "lineupId": string, "lineupName": string } |
필드 | |
---|---|
lineupId |
YouTube Select 라인업의 ID입니다. |
lineupName |
YouTube Select 라인업의 고유한 이름입니다. |
SurfaceTargetingCombinations
광고 제품에 사용할 수 있는 노출 영역 타겟팅 조합입니다.
JSON 표현 |
---|
{ "defaultTargeting": { object ( |
필드 | |
---|---|
defaultTargeting |
광고 제품에 적용된 기본 노출 영역 타겟팅입니다. |
availableTargetingCombinations[] |
광고 제품에 사용할 수 있는 표시 경로 타겟 조합입니다. |