REST Resource: advertisers.youtubeAdGroups

Resource: YoutubeAdGroup

A single YouTube ad group associated with a YouTube and Partners line item.

JSON representation
{
  "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)
  }
}
Fields
name

string

The resource name of the ad group.

advertiserId

string (int64 format)

The unique ID of the advertiser the ad group belongs to.

adGroupId

string (int64 format)

The unique ID of the ad group. Assigned by the system.

lineItemId

string (int64 format)

The unique ID of the line item that the ad group belongs to.

displayName

string

The display name of the ad group.

Must be UTF-8 encoded with a maximum size of 255 bytes.

youtubeAdIds[]

string (int64 format)

The IDs of the [youtube_ad_group_ad][] resources associated with the ad group.

adGroupFormat

enum (YoutubeAndPartnersAdGroupFormat)

The format of the ads in the ad group.

biddingStrategy

object (YoutubeAndPartnersBiddingStrategy)

The bidding strategy used by the ad group.

entityStatus

enum (EntityStatus)

Controls whether or not the ad group can spend its budget and bid on inventory.

If the ad group's parent line item is not active, the ad group can't spend its budget even if its own status is ENTITY_STATUS_ACTIVE.

targetingExpansion

object (TargetingExpansionConfig)

The targeting expansion settings of the ad group.

This config is only applicable when eligible audience list targeting is assigned to the ad group.

productFeedData

object (ProductFeedData)

The settings of the product feed in this ad group.

YoutubeAndPartnersAdGroupFormat

The format of the YouTube ad group.

Enums
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_UNSPECIFIED Format value is not specified or is unknown in this version.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_IN_STREAM In-stream ads.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_VIDEO_DISCOVERY In-feed ads.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_BUMPER Bumper ads.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM Non-skippable in-stream ads.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_AUDIO Non-skippable in-stream audio ads.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_ACTION Responsive ads for video action campaigns.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_REACH Effective reach ad groups, including in-stream and bumper ads.
YOUTUBE_AND_PARTNERS_AD_GROUP_FORMAT_MASTHEAD Masthead Ad that is surfaced on the top slot on the YouTube homepage.

ProductFeedData

The details of product feed.

JSON representation
{
  "productMatchType": enum (ProductMatchType),
  "productMatchDimensions": [
    {
      object (ProductMatchDimension)
    }
  ],
  "isFeedDisabled": boolean
}
Fields
productMatchType

enum (ProductMatchType)

How products are selected by the product feed.

productMatchDimensions[]

object (ProductMatchDimension)

A list of dimensions used to match products.

isFeedDisabled

boolean

Whether the product feed has opted-out of showing products.

ProductMatchType

The types of the ways to match products.

Enums
PRODUCT_MATCH_TYPE_UNSPECIFIED Not specified or unknown.
PRODUCT_MATCH_TYPE_ALL_PRODUCTS All the products are matched.
PRODUCT_MATCH_TYPE_SPECIFIC_PRODUCTS Specific products are selected.
PRODUCT_MATCH_TYPE_CUSTOM_LABEL Match products by their custom labels.

ProductMatchDimension

A dimension used to match products.

JSON representation
{

  // 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.
}
Fields
Union field dimension. The dimension and value on which to match the product. dimension can be only one of the following:
productOfferId

string

The ID of the product offer to match with a product with the same offer ID.

customLabel

object (CustomLabel)

The custom label to match all the products with the label.

CustomLabel

The key and value of a custom label.

JSON representation
{
  "key": enum (CustomLabelKey),
  "value": string
}
Fields
key

enum (CustomLabelKey)

The key of the label.

value

string

The value of the label.

CustomLabelKey

The key of the custom label

Enums
CUSTOM_LABEL_KEY_UNSPECIFIED Not specified or unknown.
CUSTOM_LABEL_KEY_0 Key index 0.
CUSTOM_LABEL_KEY_1 Key index 1.
CUSTOM_LABEL_KEY_2 Key index 2.
CUSTOM_LABEL_KEY_3 Key index 3.
CUSTOM_LABEL_KEY_4 Key index 4.

Methods

bulkListAdGroupAssignedTargetingOptions

Lists assigned targeting options for multiple YouTube ad groups across targeting types.

get

Gets a YouTube ad group.

list

Lists YouTube ad groups.