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。例如：同步層級位置 AssetSet ID 時，LocationGroup AssetSet 中的元素來源。這是必填欄位，而且僅適用於地區群組類型的 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 中沒有任何項目，則所有商店資訊都適合進行同步處理。標籤篩選器會以 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

地圖位置的地點 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 篩選連鎖店地點。只有屬於指定連鎖店的地點才會出現在素材資源組合中。