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 は google_product_category ID に相当します。詳しくは、https://support.google.com/merchants/answer/6324436 をご覧ください。

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 をフィルタします。1 つのアセット グループでは、このディメンションのルートノードを複数許可でき、それらの条件は「OR」とみなされます。

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

object (WebpageCondition)

ウェブページの条件では大文字と小文字が区別されます。フィルタリングの評価時に、これらの条件がまとめられて AND 処理が行われます。すべての条件は同じタイプである必要があります。例 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)

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