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 アカウントがリンクされている旅行関連の目標達成のための P-MAX キャンペーンの場合。読み取り専用です。

共用体フィールド 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 アカウントがリンクされている旅行関連の目標達成のための P-MAX キャンペーンの場合。読み取り専用です。

JSON 表現
{
  "hotelCenterId": string,
  "partnerName": string
}
フィールド
hotelCenterId

string (int64 format)

出力専用。パートナーのホテルセンター 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)

Google ビジネス プロフィールのリスティングをリスティング ID でフィルタするために使用されます。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

フィードアイテムセット内のロケーションに関する 1 つのチェーンレベルのフィルタ。すべてのフィールド間のフィルタ ロジックは 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 でチェーン店舗をフィルタするために使用されます。アセットセットに含まれるのは、指定したチェーンに属する店舗のみです。