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。このフィールドは必須で、タイプが「AssetSet」である「地域グループ」にのみ適用されます。

hotelPropertyData

object (HotelPropertyData)

出力のみ。旅行関連の目標達成のための P-MAX キャンペーンと 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

旅行関連の目標達成のための P-MAX キャンペーンと Hotel Center アカウントのリンクの場合読み取り専用です。

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

string (int64 format)

出力のみ。パートナーの Hotel Center ID。

partnerName

string

出力のみ。ホテル パートナーの名前。

LocationSet

地域セットに関連するデータ。Google ビジネス プロフィール(旧称 Google マイビジネス)のデータのうち 1 つ、チェーンデータ、地図上の位置情報を指定する必要があります。

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 にエントリが存在する場合は、いずれかのラベルが設定されているリスティングのみが、Assets と同期される候補になります。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

フィード アイテム セット内のビジネス拠点に対する 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 で、同期ソースが chain の場合にのみ適用されます。

JSON 表現
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
フィールド
dynamicChainLocationGroupFilters[]

object (ChainFilter)

チェーンのロケーションをチェーン ID でフィルタするために使用します。指定したチェーンに属する店舗のみがアセットセットに含まれます。