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 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，網址 2 = www.ads.google.com?ocid=1，且以「ocid」和「euid」表示網址「包含」條件，則網址相符，但網址 2 則不符合。

範例 2：如果網址 1 包含標籤 1、Label2 和網址 2 包含 Label2、Label3，如果使用 Label1 和 Label2 做為自訂標籤條件，則網址 1 會相符，但網址 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)

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