REST Resource: advertisers.youtubeAdGroups

리소스: YoutubeAdGroup

YouTube 및 파트너 광고 항목과 연결된 단일 YouTube 광고 그룹입니다.

JSON 표현 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "youtubeAdIds": [
    string
  ],
  "adGroupFormat": enum (YoutubeAndPartnersAdGroupFormat),
  "biddingStrategy": {
    object (YoutubeAndPartnersBiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  }
}
필드
name

string

광고 그룹의 리소스 이름입니다.
advertiserId

string (int64 format)

광고그룹이 속한 광고주의 고유 ID입니다.
adGroupId

string (int64 format)

광고 그룹의 고유 ID입니다. 시스템에서 할당합니다.
lineItemId

string (int64 format)

광고 그룹이 속한 광고 항목의 고유 ID입니다.
displayName

string

광고 그룹의 표시 이름입니다.

최대 255바이트의 UTF-8로 인코딩되어야 합니다.
youtubeAdIds[]

string (int64 format)

광고 그룹과 연결된 [youtube_ad_group_ad][] 리소스의 ID입니다.
adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

광고 그룹의 광고 형식입니다.
biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

광고 그룹에서 사용하는 입찰 전략입니다.
entityStatus

enum (EntityStatus)

광고 그룹에서 예산을 지출하고 인벤토리에 입찰할 수 있는지 여부를 제어합니다.

광고 그룹의 상위 광고 항목이 활성 상태가 아니면 광고 그룹의 상태가 ENTITY_STATUS_ACTIVE이더라도 광고 그룹에서 예산을 지출할 수 없습니다.
targetingExpansion

object (TargetingExpansionConfig)

광고 그룹의 타겟팅 확장 설정입니다.

이 구성은 요건을 충족하는 잠재고객 목록 타겟팅이 광고 그룹에 할당된 경우에만 적용됩니다.
productFeedData

object (ProductFeedData)

이 광고 그룹의 제품 피드 설정입니다.

YoutubeAndPartnersAdGroupFormat

YouTube 광고 그룹의 형식입니다.

열거형
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED 형식 값이 지정되지 않았거나 이 버전에서 알 수 없습니다.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM 인스트림 광고
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY 인피드 광고
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER 범퍼 광고
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM 건너뛸 수 없는 인스트림 광고
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO 건너뛸 수 없는 인스트림 오디오 광고
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION 동영상 액션 캠페인의 반응형 광고
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH 인스트림 광고 및 범퍼 광고를 포함한 효과적인 도달범위 광고 그룹
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD YouTube 홈페이지의 상단 슬롯에 표시되는 마스트헤드 광고입니다.

ProductFeedData

제품 피드의 세부정보입니다.

JSON 표현 
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
필드
productMatchType

enum (ProductMatchType)

제품 피드에서 제품이 선택되는 방식입니다.
productMatchDimensions[]

object (ProductMatchDimension)

제품을 일치시키는 데 사용되는 측정기준 목록입니다.
isFeedDisabled

boolean

제품 피드에서 제품 표시를 선택 해제했는지 여부입니다.

ProductMatchType

제품을 일치시키는 방법의 유형입니다.

열거형
PRODUCT_MATCH_TYPE_UNSPECIFIED 지정되지 않았거나 알 수 없습니다.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS 모든 제품이 일치합니다.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS 특정 제품이 선택됩니다.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL 맞춤 라벨을 기준으로 제품을 일치시킵니다.

ProductMatchDimension

제품을 일치시키는 데 사용되는 측정기준입니다.

JSON 표현 
{

  // Union field dimension can be only one of the following:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of list of possible types for union field dimension.
}
필드
통합 필드 dimension. 제품과 일치하는 크기 및 값입니다. dimension은 다음 중 하나여야 합니다.
productOfferId

string

혜택 ID가 동일한 제품과 일치시킬 제품 ID입니다.
customLabel

object (CustomLabel)

라벨이 지정된 모든 제품과 일치하는 맞춤 라벨입니다.

CustomLabel

맞춤 라벨의 키 및 값입니다.

JSON 표현 
{
  "key": enum (CustomLabelKey),
  "value": string
}
필드
key

enum (CustomLabelKey)

라벨의 키입니다.
value

string

라벨 값입니다.

CustomLabelKey

맞춤 라벨의 키입니다.

열거형
CUSTOM_LABEL_KEY_UNSPECIFIED 지정되지 않거나 알 수 없음
CUSTOM_LABEL_KEY_0 키 색인 0
CUSTOM_LABEL_KEY_1 키 색인 1.
CUSTOM_LABEL_KEY_2 키 색인 2.
CUSTOM_LABEL_KEY_3 키 색인 3.
CUSTOM_LABEL_KEY_4 키 색인 4.

메서드

bulkListAdGroupAssignedTargetingOptions

 여러 타겟팅 유형에 걸쳐 여러 YouTube 광고 그룹에 할당된 타겟팅 옵션을 나열합니다.

get

 YouTube 광고 그룹을 가져옵니다.

list

 YouTube 광고 그룹을 나열합니다.