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

不可變動。母商家資訊群組子群組的資源名稱。根清單群組篩選器節點的空值。
path

object (ListingGroupFilterDimensionPath)

僅供輸出。用來定義這個商家資訊群組篩選器的維度路徑。

ListingGroupFilterType

商家資訊群組篩選器的類型。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
SUBDIVISION 依據部分產品資訊維度細分產品。
UNIT_INCLUDED 納入的商家資訊群組篩選器分葉節點。
UNIT_EXCLUDED 已排除的商家資訊群組篩選器分葉節點。

ListingGroupFilterListingSource

依商家資訊群組篩選器節點篩選的商家資訊來源。

列舉
UNSPECIFIED 未指定。
UNKNOWN 僅用於傳回值。代表這個版本未知的值。
SHOPPING 購物來源中的產品資訊，例如 Google Merchant Center 中的產品。
WEBPAGE 來自網頁來源的商家資訊，例如來自網頁動態饋給或廣告主網域的網址。

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)

用於篩選網頁動態饋給中的網址和來自廣告客戶網域的網址。

ProductCategory

屬於特定層級的類別元素。頂層類別位於第 1 層級，其子項為第 2 層級，依此類推。系統目前最多支援 5 個等級。使用者必須指定維度類型，指出類別層級。同一個子產品群組的所有情況都必須具有相同的維度類型 (類別層級)。

JSON 表示法 
{
  "level": enum (ListingGroupFilterProductCategoryLevel),
  "categoryId": string
}
欄位
level

enum (ListingGroupFilterProductCategoryLevel)

指出分類中的類別層級。
categoryId

string (int64 format)

產品類別的 ID。

這個 ID 等同於 google_product_category [Google 產品類別] 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 第二項商家資訊群組篩選器自訂屬性。
INDEX2 第三個商家資訊群組篩選器自訂屬性。
INDEX3 第四個商家資訊群組篩選器自訂屬性。
INDEX4 第五個商家資訊群組篩選器自訂屬性。

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 級：

網頁

用於篩選網頁動態饋給中的網址和來自廣告客戶網域的網址。素材資源群組中可以使用多個具有這項維度的根節點，「或」會將這些條件納入考量。

JSON 表示法 
{
  "conditions": [
    {
      object (WebpageCondition)
    }
  ]
}
欄位
conditions[]

object (WebpageCondition)

網頁條件會區分大小寫，而在評估要篩選時，將會同時納入這些條件。所有條件都必須屬於相同類型。範例 1：如果網址 1 = www.ads.google.com?ocid=1&euid=2 且 URL2 = www.ads.google.com?ocid=1，並以「ocid」和「euid」做為網址包含條件，則系統會比對網址 1，但不比對網址 2。

範例 2：如果網址 1 有 Label1，標籤 2 和網址 2 包含 Label2、Label3，其中 Label1 和 Label2 都是自訂標籤條件，會比對 URL1，但不會比對網址 2。如果使用 Label2 做為唯一的自訂標籤條件，系統會比對網址 1 和網址 2。

WebpageCondition

網址篩選的比對條件。

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。網址篩選條件。condition 只能採用下列其中一種設定：
customLabel

string

篩選網頁動態饋給中包含這個自訂標籤的網址。您可以建立「PAGE_FEED」類型的 AssetSet，並使用 CampaignAssetSet 連結至廣告活動，藉此在廣告活動中加入自訂標籤。
urlContains

string

篩選網頁動態饋給中的網址，以及來自廣告客戶網域且包含此字串的網址。

ListingGroupFilterDimensionPath

用來定義維度定義商家資訊群組篩選器的路徑。

JSON 表示法 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
欄位
dimensions[]

object (ListingGroupFilterDimension)

僅供輸出。商家資訊群組篩選器階層 (根節點除外) 至這個商家資訊群組篩選器的完整維度路徑。