REST Resource: advertisers.youtubeAdGroups

リソース: YoutubeAdGroup

YouTube とパートナーの広告申込情報に関連付けられた 1 つの 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

広告グループの表示名。

UTF-8 でエンコードし、最大サイズは 255 バイトにする必要があります。
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 広告グループを一覧表示します。