AssetGroupListingGroupFilter

AssetGroupListingGroupFilter は、アセット グループ内のリスティング グループのフィルタ ツリーノードを表します。

JSON 表現 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "listingSource": enum (ListingGroupFilterListingSource),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
フィールド
resourceName

string

変更不可。アセット グループのリスティング グループ フィルタのリソース名。アセット グループのリスティング グループのフィルタのリソース名の形式:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

変更不可。このアセット グループのリスティング グループ フィルタが属するアセット グループ。
id

string (int64 format)

出力のみ。ListingGroupFilter の ID。
type

enum (ListingGroupFilterType)

変更不可。リスティング グループのフィルタノードのタイプ。
listingSource

enum (ListingGroupFilterListingSource)

変更不可。このリスティング グループ フィルタでフィルタされたリスティングのソース。
caseValue

object (ListingGroupFilterDimension)

このリスティング グループが親を絞り込むために使用するディメンション値。ルートグループに対して未定義です。
parentListingGroupFilter

string

変更不可。親リスティング グループの区分のリソース名。ルート リスティング グループのフィルタノードの場合は null。
path

object (ListingGroupFilterDimensionPath)

出力のみ。このリスティング グループ フィルタを定義するディメンションのパス。

ListingGroupFilterType

リスティング グループのフィルタのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SUBDIVISION 一部のリスティング サイズに沿った商品の区分。
UNIT_INCLUDED 含まれるリスティング グループのフィルタのリーフノード。
UNIT_EXCLUDED 除外されたリスティング グループのフィルタのリーフノード。

ListingGroupFilterListingSource

リスティング グループのフィルタノードでフィルタされたリスティングのソース。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
SHOPPING ショッピング ソースからのリスティング（Google Merchant Center の商品など）。
WEBPAGE ウェブページ ソースからのリスティング（ページフィードの URL や広告主のウェブドメインの URL など）。

ListingGroupFilterDimension

アセット グループのリスティング グループ フィルタのリスティング ディメンション。

JSON 表現 
{

  // Union field dimension can be only one of the following:
  "productCategory": {
    object (ProductCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  },
  "webpage": {
    object (Webpage)
  }
  // End of list of possible types for union field dimension.
}
フィールド
共用体フィールド dimension。以下のいずれかのタイプのディメンションが常に存在します。dimension は次のいずれかになります。
productCategory

object (ProductCategory)

商品のカテゴリ。
productBrand

object (ProductBrand)

商品のブランド。
productChannel

object (ProductChannel)

商品の地域。
productCondition

object (ProductCondition)

商品の状態。
productCustomAttribute

object (ProductCustomAttribute)

商品のカスタム属性。
productItemId

object (ProductItemId)

商品の商品アイテム ID。
productType

object (ProductType)

商品情報のタイプ。
webpage

object (Webpage)

ページフィードの URL と広告主のウェブドメインの URL をフィルタします。

ProductCategory

特定のレベルのカテゴリの 1 つの要素。最上位のカテゴリはレベル 1 に、その子はレベル 2 のようになります。現在、最大 5 つのレベルがサポートされています。ユーザーは、カテゴリのレベルを示すディメンション タイプを指定する必要があります。同じ下位分類のすべてのケースは、同じディメンション タイプ（カテゴリレベル）である必要があります。

JSON 表現 
{
  "level": enum (ListingGroupFilterProductCategoryLevel),
  "categoryId": string
}
フィールド
level

enum (ListingGroupFilterProductCategoryLevel)

分類におけるカテゴリのレベルを示します。
categoryId

string (int64 format)

商品カテゴリの ID。

この ID は、https://support.google.com/merchants/answer/6324436 の記事で説明されている google_product_category ID に相当します。

ListingGroupFilterProductCategoryLevel

リスティング グループ フィルタの商品カテゴリのレベル。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEVEL1 レベル 1。
LEVEL2 レベル 2。
LEVEL3 レベル 3。
LEVEL4 レベル 4。
LEVEL5 レベル 5。

ProductBrand

商品のブランド。

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

string

商品ブランドの文字列値。

ProductChannel

商品の地域。

JSON 表現 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
フィールド
channel

enum (ListingGroupFilterProductChannel)

地域の値。

ListingGroupFilterProductChannel

商品の地域区分を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ONLINE この商品はオンラインで販売されています。
LOCAL その商品は実店舗で販売されています。

ProductCondition

商品の状態。

JSON 表現 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
フィールド
condition

enum (ListingGroupFilterProductCondition)

条件の値。

ListingGroupFilterProductCondition

商品の条件を記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
NEW 商品の状態が新品であること。
REFURBISHED 商品の状態は再生品です。
USED 商品の状態が使用されます。

ProductCustomAttribute

商品のカスタム属性。

JSON 表現 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
フィールド
index

enum (ListingGroupFilterCustomAttributeIndex)

カスタム属性のインデックスを示します。
value

string

商品のカスタム属性の文字列値。

ListingGroupFilterCustomAttributeIndex

顧客属性のインデックス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
INDEX0 最初のリスティング グループ フィルタのカスタム属性。
INDEX1 2 つ目のリスティング グループ フィルタのカスタム属性。
INDEX2 3 つ目のリスティング グループ フィルタのカスタム属性。
INDEX3 4 番目のリスティング グループ フィルタのカスタム属性。
INDEX4 5 番目のリスティング グループ フィルタのカスタム属性。

ProductItemId

商品の商品アイテム ID。

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

string

ID の値。

ProductType

商品情報のタイプ。

JSON 表現 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
フィールド
level

enum (ListingGroupFilterProductTypeLevel)

タイプのレベル。
value

string

タイプの値。

ListingGroupFilterProductTypeLevel

商品情報のタイプのレベルを記述する列挙型。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
LEVEL1 レベル 1。
LEVEL2 レベル 2。
LEVEL3 レベル 3。
LEVEL4 レベル 4。
LEVEL5 レベル 5。

ウェブページ

ページフィードの URL と広告主のウェブドメインの URL をフィルタします。アセット グループでは、このディメンションを持つ複数のルートノードが許可されており、それらの条件は OR とみなされます。

JSON 表現 
{
  "conditions": [
    {
      object (WebpageCondition)
    }
  ]
}
フィールド
conditions[]

object (WebpageCondition)

ウェブページの条件では大文字と小文字が区別されます。フィルタの評価時には、これらの条件がまとめられて結合されます。条件はすべて同じタイプでなければなりません。例 1: URL1 が www.ads.google.com?ocid=1&euid=2、URL2 が www.ads.google.com?ocid=1 で、urlContains 条件が「ocid」と「euid」の場合、URL1 は一致しますが、URL2 は一致しません。

例 2 : URL1 に Label1、Label2、URL2 に Label2、Label3 が含まれ、さらに Label1 と Label2 の条件が customLabel 条件である場合、URL1 は一致しますが URL2 は一致しません。一方の customLabel 条件が Label2 のみの場合、URL1 と URL2 の両方が一致します。

WebpageCondition

URL フィルタリングの一致条件。

JSON 表現 
{

  // Union field condition can be only one of the following:
  "customLabel": string,
  "urlContains": string
  // End of list of possible types for union field condition.
}
フィールド
共用体フィールド condition。URL をフィルタする条件。condition には次のいずれか 1 つだけを指定できます。
customLabel

string

このカスタムラベルを持つページフィードの URL をフィルタします。カスタムラベルをキャンペーンに追加するには、PAGE_Feed タイプの AssetSet を作成し、CampaignAssetSet を使用してキャンペーンにリンクします。
urlContains

string

ページフィードの URL と、この文字列を含む広告主のウェブドメインの URL をフィルタします。

ListingGroupFilterDimensionPath

リスティング グループのフィルタを定義するディメンションのパス。

JSON 表現 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
フィールド
dimensions[]

object (ListingGroupFilterDimension)

出力のみ。リスティング グループのフィルタ階層（ルートノードを除く）を通過するディメンションの、このリスト グループ フィルタへの完全パス。