Method: advertisers.reachForecast.retrievePlannableUserInterests

예측에 사용할 수 있는 Google 잠재고객 (사용자 관심분야)을 가져옵니다.

HTTP 요청

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableUserInterests

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

경로 매개변수

매개변수
advertiserId

string (int64 format)

필수 항목입니다. 계획 가능한 사용자 관심분야를 나열할 광고주의 ID입니다.

쿼리 매개변수

매개변수
productCategory

enum (PlannableProductCategory)

필수 항목입니다. 계획 가능한 사용자 관심분야를 가져올 제품 카테고리입니다.

요청 본문

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

응답 본문

reachForecast.retrievePlannableUserInterests의 응답입니다.

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

JSON 표현 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
필드
plannableUserInterests[]

object (PlannableUserInterest)

계획 가능한 사용자 관심분야 (Google 잠재고객) 목록입니다.

승인 범위

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

  • https://www.googleapis.com/auth/display-video

자세한 내용은 OAuth 2.0 Overview를 참조하세요.

PlannableUserInterest

타겟팅에 사용되는 계획 가능한 사용자 관심분야입니다.

JSON 표현 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
필드
userInterestDisplayName

string

출력 전용입니다. 관심분야의 표시 이름입니다(예: '아웃도어 애호가').
userInterestPath

string

출력 전용입니다. 관심분야의 카테고리 경로입니다.
userInterestType

string

출력 전용입니다. 잠재고객 유형입니다(예: 'AFFINITY', 'IN_MARKET').
userInterest

object (UserInterest)

출력 전용입니다. 사용자 관심분야의 식별자입니다.

요청에 지정된 [productCategory][] 에 따라 객체에 채워지는 필드가 결정됩니다.

  • [userInterestCategory][] 는 'YouTube'에 채워집니다.
  • [userInterestUserList][] 는 '공개 입찰'에 채워집니다.

UserInterest

사용자 관심분야의 식별자입니다.

JSON 표현 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
필드
userInterestCategory

string

출력 전용입니다. 관심분야 카테고리의 리소스 이름입니다. productCategory가 'YouTube'인 경우 채워집니다. 형식: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

출력 전용입니다. 사용자 목록의 리소스 이름입니다. productCategory가 '공개 입찰'인 경우 채워집니다. 형식: customers/{customerId}/userLists/{user_list_id}