AssetSet

代表資產集合的資產組合。使用 AssetSetAsset 將資產連結至素材資源組合。

JSON 表示法 
{
  "id": string,
  "resourceName": string,
  "name": string,
  "type": enum (AssetSetType),
  "status": enum (AssetSetStatus),
  "merchantCenterFeed": {
    object (MerchantCenterFeed)
  },
  "locationGroupParentAssetSetId": string,
  "hotelPropertyData": {
    object (HotelPropertyData)
  },

  // Union field asset_set_source can be only one of the following:
  "locationSet": {
    object (LocationSet)
  },
  "businessProfileLocationGroup": {
    object (BusinessProfileLocationGroup)
  },
  "chainLocationGroup": {
    object (ChainLocationGroup)
  }
  // End of list of possible types for union field asset_set_source.
}
欄位
id

string (int64 format)

僅供輸出。素材資源組合 ID。
resourceName

string

不可變動。資產集的資源名稱。資產集資源名稱的格式如下：

customers/{customerId}/assetSets/{asset_set_id}
name

string

必要欄位。資產集合的名稱。必要欄位。長度必須介於 1 到 128 之間。
type

enum (AssetSetType)

必要欄位。不可變動。素材資源組合類型。必填。
status

enum (AssetSetStatus)

僅供輸出。素材資源組合的狀態。唯讀。
merchantCenterFeed

object (MerchantCenterFeed)

Google Merchant Center 的商家 ID 和動態饋給標籤。
locationGroupParentAssetSetId

string (int64 format)

不可變動。此素材資源組合元素來源的素材資源組合父項 ID。例如：LocationGroup AssetSet 中的元素來自同步層級地點 AssetSet ID。這個欄位為必填欄位，僅適用於 Location Group 類型的 AssetSet。
hotelPropertyData

object (HotelPropertyData)

僅供輸出。適用於連結 Hotel Center 帳戶的旅遊目標專用最高成效廣告活動。唯讀。
聯集欄位 asset_set_source。素材資源組合資料 (適用於各素材資源組合類型)。並非所有類型都有特定資料。asset_set_source 只能是下列其中一項：
locationSet

object (LocationSet)

地點素材資源集合資料。這會用於同步處理層級位置設定。只有在 AssetSet 的類型為 LOCATION_SYNC 時，才能設定這個值。
businessProfileLocationGroup

object (BusinessProfileLocationGroup)

商家檔案地區群組素材資源集合資料。
chainLocationGroup

object (ChainLocationGroup)

代表連鎖店動態地區群組的相關資訊。只有在 AssetSet 的同步層級類型為 LOCATION_SYNC，且同步來源為 chain 時才適用。

AssetSetStatus

素材資源組合可能的狀態。

列舉
UNSPECIFIED 未指定狀態。
UNKNOWN 這個版本不支援接收值。這是僅供回應使用的值。
ENABLED 素材資源組合已啟用。
REMOVED 素材資源集已移除。

MerchantCenterFeed

Google Merchant Center 的商家 ID 和動態饋給標籤。

JSON 表示法 
{
  "merchantId": string,
  "feedLabel": string
}
欄位
merchantId

string (int64 format)

必要欄位。Google Merchant Center 的商家 ID
feedLabel

string

選用設定。Google Merchant Center 的動態饋給標籤。

HotelPropertyData

適用於連結 Hotel Center 帳戶的旅遊目標專用最高成效廣告活動。唯讀。

JSON 表示法 
{
  "hotelCenterId": string,
  "partnerName": string
}
欄位
hotelCenterId

string (int64 format)

僅供輸出。合作夥伴的 Hotel Center ID。
partnerName

string

僅供輸出。飯店合作夥伴的名稱。

LocationSet

與位置集合相關的資料。您必須指定一項 Google 商家檔案 (舊稱 Google 我的商家) 資料、連鎖資料和地圖位置資料。

JSON 表示法 
{
  "locationOwnershipType": enum (LocationOwnershipType),

  // Union field source can be only one of the following:
  "businessProfileLocationSet": {
    object (BusinessProfileLocationSet)
  },
  "chainLocationSet": {
    object (ChainSet)
  },
  "mapsLocationSet": {
    object (MapsLocationSet)
  }
  // End of list of possible types for union field source.
}
欄位
locationOwnershipType

enum (LocationOwnershipType)

必要欄位。不可變動。地點擁有權類型 (自有地點或經銷地點)。
聯集欄位 source。每個同步來源的專屬位置資料。source 只能是下列其中一項：
businessProfileLocationSet

object (BusinessProfileLocationSet)

用於設定 Google 商家檔案地點的資料。
chainLocationSet

object (ChainSet)

用於設定鏈結集上位置的資料，該鏈結集會填入指定的鏈結。
mapsLocationSet

object (MapsLocationSet)

只有在位置資訊是根據所選地圖位置同步時，才會設定

BusinessProfileLocationSet

用於設定 Google 商家檔案地點的資料。如果指定不同類型的篩選器，系統會以 AND 組成交集。

JSON 表示法 
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
欄位
httpAuthorizationToken

string

必要欄位。不可變動。用於取得授權的 HTTP 授權權杖。
emailAddress

string

必要欄位。不可變動。Google 商家檔案帳戶的電子郵件地址，或 Google 商家檔案帳戶管理員的電子郵件地址。
businessNameFilter

string

用於依商家名稱篩選 Google 商家檔案資訊。如果設定了 businessNameFilter，只有商家名稱相符的商家資訊才會同步至資產。
labelFilters[]

string

用於依標籤篩選 Google 商家檔案資訊。如果 labelFilters 中含有項目，則只有已設定任何標籤的產品資訊才會同步至素材資源。如果 labelFilters 中沒有任何項目，則所有產品資訊都會成為同步的候選項目。標籤篩選器會以 OR 組成交集。
listingIdFilters[]

string (int64 format)

用於依據商家檔案 ID 篩選 Google 商家檔案資訊。如果「listingIdFilters」中含有項目，則只有篩選條件指定的產品才會同步至「資產」。如果 listingIdFilters 中沒有任何項目，則所有產品資訊都會列為同步對象。房源 ID 篩選條件會以 OR 組成交集。
businessAccountId

string

不可變動。要使用的受管理商家帳戶 ID。如果未設定這個欄位，系統就會使用使用者可存取的所有商家 (由 emailAddress 指定)。

ChainSet

用於設定位置集的資料，該集合會填入指定的連鎖店。

JSON 表示法 
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
欄位
relationshipType

enum (ChainRelationshipType)

必要欄位。不可變動。指定連鎖店與這個廣告主之間的關係類型。
chains[]

object (ChainFilter)

必要欄位。鏈結層級篩選條件清單，所有篩選條件會以 OR 連接。

ChainRelationshipType

關係的可能類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的值不明。
AUTO_DEALERS 汽車經銷商關係。
GENERAL_RETAILERS 一般零售商關係。

鏈結篩選器

動態饋給項目組合中，針對地點設定一個連鎖層級篩選器。所有欄位的篩選邏輯都是「AND」。

JSON 表示法 
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
欄位
chainId

string (int64 format)

必要欄位。用於依連鎖店 ID 篩選連鎖店地點。只有屬於指定連鎖店的連鎖店地點才會列入素材資源集合。
locationAttributes[]

string

用於依據地點屬性篩選連鎖店地點。只有屬於所有指定屬性的連鎖店位置才會納入資產集。如果這個欄位留空，表示系統不會對這個欄位進行篩選。

MapsLocationSet

多個地圖位置同步資料的包裝函式

JSON 表示法 
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
欄位
mapsLocations[]

object (MapsLocationInfo)

必要欄位。使用者手動同步的 Google 地圖位置資訊清單。

MapsLocationInfo

地點 ID 的包裝函式

JSON 表示法 
{
  "placeId": string
}
欄位
placeId

string

Google 地圖位置的地點 ID。

BusinessProfileLocationGroup

商家檔案動態地區群組的相關資訊。只有在同步層級 AssetSet 類型為 LOCATION_SYNC，且同步來源為商家檔案時，才適用。

JSON 表示法 
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
欄位
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

篩選動態商家檔案地點組合。

DynamicBusinessProfileLocationGroupFilter

代表素材資源集合中商家檔案地點的篩選器。如果提供多個篩選器，系統會以 AND 組成交集。

JSON 表示法 
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
欄位
labelFilters[]

string

用於依標籤篩選商家檔案地點。只有含有上述任一標籤的地點才會納入資產集。標籤篩選器會以 OR 組成交集。
listingIdFilters[]

string (int64 format)

用於依商家資訊卡 ID 篩選商家檔案地點。
businessNameFilter

object (BusinessProfileBusinessNameFilter)

用於依商家名稱篩選商家檔案地點。

BusinessProfileBusinessNameFilter

商家檔案地區群組的商家名稱篩選器。

JSON 表示法 
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
欄位
businessName

string

用於篩選的商家名稱字串。
filterType

enum (LocationStringFilterType)

使用 businessName 篩選時要使用的字串比對類型。

LocationStringFilterType

可能的地區字串篩選器類型。

列舉
UNSPECIFIED 不指定。
UNKNOWN 僅用於傳回值。代表這個版本中的值不明。
EXACT 篩選器會使用完全比對字串。

ChainLocationGroup

代表連鎖店動態地區群組的相關資訊。只有在 AssetSet 的同步層級類型為 LOCATION_SYNC，且同步來源為 chain 時才適用。

JSON 表示法 
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
欄位
dynamicChainLocationGroupFilters[]

object (ChainFilter)

用於依據連鎖商店 ID 篩選連鎖店地點。只有屬於指定連鎖店的地區才會列入素材資源集合。