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。例如：同步層級 location AssetSet ID，其中 LocationGroup AssetSet 中的元素來自該 ID。這個欄位是必填欄位，僅適用於地區群組類型的 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，且同步處理來源為鏈結時，才適用。

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 一般零售商關係。

ChainFilter

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

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

string (int64 format)

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

string

用於依據位置屬性篩選連鎖店地點。只有屬於所有指定屬性的連鎖店地點才會納入素材資源組合。如果這個欄位空白，表示不對這個欄位進行篩選。

MapsLocationSet

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

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

object (MapsLocationInfo)

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

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，且同步處理來源為鏈結時，才適用。

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

object (ChainFilter)

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