REST Resource: advertisers.adGroups

リソース: AdGroup

広告申込情報に関連付けられた 1 つの広告グループ。

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

出力専用。ID。広告グループのリソース名。
advertiserId

string (int64 format)

出力専用。広告グループが属する広告主の一意の ID。
adGroupId

string (int64 format)

出力専用。広告グループの一意の ID。システムによって割り当てられます。
lineItemId

string (int64 format)

必須。変更不可。広告グループが属する広告申込情報の一意の ID。
displayName

string

必須。広告グループの表示名。

UTF-8 でエンコードされ、最大サイズが 255 バイトである必要があります。
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.
}
フィールド
商品を一致させるディメンションと値。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
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.
}
フィールド
広告グループの広告在庫管理機能。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
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 ショート広告枠にオプトインされているかどうか。
allowYoutubeFeed

boolean

広告グループが YouTube インフィード広告枠を有効にしているかどうか。
allowDiscover

boolean

広告グループが Discover 広告枠にオプトインされているかどうか。
allowGmail

boolean

広告グループが Gmail の広告枠にオプトインされているかどうか。
allowGoogleDisplayNetwork

boolean

広告グループが Google ディスプレイ ネットワークの広告枠にオプトインしているかどうか。

AdSource

この adGroup の広告のソース。

列挙型
AD_SOURCE_UNSPECIFIED 指定されていないか、不明です。デフォルトは通常の広告ソースです。
AD_SOURCE_DV360_CREATIVE ディスプレイ＆ビデオ 360 のクリエイティブから取得。

CreativeAssignment

広告グループに割り当てられたクリエイティブの詳細。

JSON 表現 
{
  "creativeId": string
}
フィールド
creativeId

string (int64 format)

必須。広告グループに割り当てられたディスプレイ＆ビデオ 360 のクリエイティブの ID。

メソッド

bulkEditAssignedTargetingOptions

 複数の広告グループのターゲティング オプションを一括編集します。

bulkListAssignedTargetingOptions

 複数の広告グループに割り当てられているターゲティング オプションを、ターゲティング タイプ別に一覧表示します。

create

 新しい広告グループを作成します。

delete

 広告グループを削除します。

get

 広告グループを取得します。

list

 広告グループを一覧表示します。

patch

 既存の広告グループを更新します。