REST Resource: advertisers.adGroups

리소스: AdGroup

광고 항목과 연결된 단일 광고 그룹입니다.

JSON 표현 
{
  "name": string,
  "advertiserId": string,
  "adGroupId": string,
  "lineItemId": string,
  "displayName": string,
  "adGroupFormat": enum (AdGroupFormat),
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "entityStatus": enum (EntityStatus),
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "productFeedData": {
    object (ProductFeedData)
  },
  "adGroupInventoryControl": {
    object (AdGroupInventoryControl)
  },
  "adSource": enum (AdSource),
  "creativeAssignments": [
    {
      object (CreativeAssignment)
    }
  ]
}
필드
name

string

출력 전용입니다. 식별자. 광고 그룹의 리소스 이름입니다.
advertiserId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

필수 항목입니다. 변경할 수 없습니다. 광고 그룹이 속한 광고 항목의 고유 ID입니다.
displayName

string

필수 항목입니다. 광고 그룹의 표시 이름입니다.

최대 크기가 255바이트인 UTF-8로 인코딩되어야 합니다.
adGroupFormat

enum (AdGroupFormat)

필수 항목입니다. 변경할 수 없습니다. 광고 그룹에 있는 광고의 형식입니다.
bidStrategy

object (BiddingStrategy)

선택사항입니다. 광고 그룹에서 사용하는 입찰 전략입니다. 입찰 전략에는 youtubeAndPartnersBid 및 demandGenBid 필드만 사용할 수 있습니다.
entityStatus

enum (EntityStatus)

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

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

object (TargetingExpansionConfig)

선택사항입니다. 광고 그룹의 타겟팅 최적화 설정입니다.
productFeedData

object (ProductFeedData)

선택사항입니다. 이 광고 그룹의 제품 피드 설정입니다.
adGroupInventoryControl

object (AdGroupInventoryControl)

선택사항입니다. 디맨드젠 광고 그룹에 필요합니다. 광고 그룹의 인벤토리 관리를 지정합니다.
adSource

enum (AdSource)

선택사항입니다. 이 광고 그룹에 속한 광고의 소스입니다. 이 필드는 지정된 소스에서 광고가 자동으로 생성되는 경우에만 사용됩니다.
creativeAssignments[]

object (CreativeAssignment)

선택사항입니다. 광고 그룹에서 광고를 생성하는 데 사용되는 광고 소재입니다.

이 필드는 adSource가 AD_SOURCE_DV360_CREATIVE인 경우에만 할당할 수 있습니다.

AdGroupFormat

광고 그룹의 형식입니다.

열거형
AD_GROUP_FORMAT_UNSPECIFIED 형식 값이 지정되지 않았거나 이 버전에서 알 수 없습니다.
AD_GROUP_FORMAT_IN_STREAM 인스트림 광고
AD_GROUP_FORMAT_VIDEO_DISCOVERY 인피드 광고
AD_GROUP_FORMAT_BUMPER 범퍼 광고
AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM 건너뛸 수 없는 인스트림 광고
AD_GROUP_FORMAT_AUDIO 건너뛸 수 없는 인스트림 오디오 광고
AD_GROUP_FORMAT_RESPONSIVE 반응형 광고
AD_GROUP_FORMAT_REACH 인스트림 광고 및 범퍼 광고를 포함한 효율적 잠재고객 도달 광고 그룹
AD_GROUP_FORMAT_MASTHEAD YouTube 홈페이지 상단 슬롯에 표시되는 마스트헤드 광고
AD_GROUP_FORMAT_DEMAND_GEN 디맨드젠 광고

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 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "productOfferId": string,
  "customLabel": {
    object (CustomLabel)
  }
  // End of mutually exclusive fields.
}
필드
제품을 일치시킬 측정기준 및 값입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
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.

AdGroupInventoryControl

광고 그룹의 인벤토리 관리입니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "adGroupInventoryStrategy": enum (AdGroupInventoryStrategy),
  "selectedInventories": {
    object (SelectedInventories)
  }
  // End of mutually exclusive fields.
}
필드
광고 그룹의 인벤토리 관리입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
adGroupInventoryStrategy

enum (AdGroupInventoryStrategy)

인벤토리 전략입니다.
selectedInventories

object (SelectedInventories)

선택한 인벤토리입니다.
상호 배타적인 필드의 끝입니다.

AdGroupInventoryStrategy

광고 그룹의 인벤토리 전략입니다.

열거형
AD_GROUP_INVENTORY_STRATEGY_UNSPECIFIED 지정되지 않았거나 알 수 없습니다.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_AND_DISPLAY_NETWORK_INVENTORY 광고 그룹이 모든 Google 및 디스플레이 네트워크 인벤토리에 게재되도록 선택되어 있습니다.
AD_GROUP_INVENTORY_STRATEGY_ALL_GOOGLE_INVENTORY 광고 그룹이 모든 Google 인벤토리에 선택되어 있습니다.

SelectedInventories

광고 그룹의 인벤토리 관리입니다.

JSON 표현 
{
  "allowYoutubeStream": boolean,
  "allowYoutubeShorts": boolean,
  "allowYoutubeFeed": boolean,
  "allowDiscover": boolean,
  "allowGmail": boolean,
  "allowGoogleDisplayNetwork": boolean
}
필드
allowYoutubeStream

boolean

광고 그룹이 YouTube 인스트림 인벤토리를 선택했는지 여부입니다.
allowYoutubeShorts

boolean

광고 그룹이 YouTube Shorts 인벤토리에 선택되어 있는지 여부입니다.
allowYoutubeFeed

boolean

광고 그룹이 YouTube 인피드 인벤토리를 선택했는지 여부입니다.
allowDiscover

boolean

광고 그룹이 디스커버 인벤토리를 선택했는지 여부입니다.
allowGmail

boolean

광고 그룹이 Gmail 인벤토리를 선택했는지 여부입니다.
allowGoogleDisplayNetwork

boolean

광고 그룹이 Google 디스플레이 네트워크 인벤토리를 선택했는지 여부입니다.

AdSource

이 광고그룹에 속한 광고의 소스입니다.

열거형
AD_SOURCE_UNSPECIFIED 지정되지 않았거나 알 수 없습니다. 기본값은 일반 광고 소스입니다.
AD_SOURCE_DV360_CREATIVE DV360 광고 소재에서 가져옵니다.

CreativeAssignment

광고 그룹에 할당된 광고 소재의 세부정보입니다.

JSON 표현 
{
  "creativeId": string
}
필드
creativeId

string (int64 format)

필수 항목입니다. 광고 그룹에 할당된 Display & Video 360 광고 소재의 ID입니다.

메서드

bulkEditAssignedTargetingOptions

 여러 광고 그룹의 타겟팅 옵션을 일괄 수정합니다.

bulkListAssignedTargetingOptions

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

create

 새 광고 그룹을 만듭니다.

delete

 광고 그룹을 삭제합니다.

get

 광고 그룹을 가져옵니다.

list

 광고 그룹을 나열합니다.

patch

 기존 광고 그룹을 업데이트합니다.