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/{assetGroupId}~{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 など）。

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)

ウェブページの条件では大文字と小文字が区別され、フィルタの評価時に条件が 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 を指定すると、URL1 は一致しますが、URL2 は一致しません。カスタムラベルの条件が 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 は次のいずれかになります。
customLabel

string

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

string

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

ListingGroupFilterDimensionPath

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

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

object (ListingGroupFilterDimension)

出力専用。リスティング グループ フィルタ階層（ルートノードは除く）からこのリスティング グループ フィルタまでのディメンションの完全なパス。