住所アセット
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
他のアセットとは異なり、住所アセットはアセットセットを作成した後に Google Ads API によって自動的に作成されます。まず、住所同期アセット セットを作成して、顧客に割り当てます。次に、キャンペーンまたは広告グループのアセットセットで住所アセットのサブセットを選択する必要がある場合は、住所グループ アセットセットを作成して、キャンペーンまたは広告グループに関連付けます。
住所同期アセット セットを作成して顧客に関連付ける
- ビジネス情報の同期アセット セットを作成します。
CustomerAssetSetService
を使用して顧客にアタッチします。
住所同期アセット セットを作成する
- 新しい
AssetSet
を作成します。
type
を LOCATION_SYNC
に設定します。
location_set
を新しい LocationSet
に設定します。
- 新しい
LocationSet
で、
- ユースケースに基づいて
location_ownership_type
を設定します。
- ユースケースに基づいて
source
oneof フィールドを設定します。
- Google ビジネス プロフィール アカウントの所在地と同期する場合は、
business_profile_location_set
を設定します。
- 指定したチェーン ID の拠点と同期する場合は、
chain_location_set
を設定します。
- プレイス ID を使用して場所を手動で追加する場合は、
maps_location_set
を設定します。
これらの手順を完了すると、Google 広告 API は地域情報アセットを生成し、作成した地域情報同期アセット セットに追加します。これは、AssetSetAssetService
を使用して手動で追加する場合と同様です。静的ロケーション グループ アセットセットに手動で追加する場合を除き、操作する必要はありません。
お客様に対して存在できる有効なロケーション同期アセット セットは 1 つのみです(ENABLED
の status
)。別のタイプの住所同期アセット セットを作成する必要がある場合は、まず既存のものを削除します。
位置情報同期アセット セットを顧客にリンクする
CustomerAssetSetService.MutateCustomerAssetSets
を使用して、前のセクションで設定した住所同期アセット セットを顧客に関連付けます。
(省略可)地域グループ アセット セットを作成してキャンペーンまたは広告グループに関連付ける
地域グループのアセット セットは、住所アセットのサブセットを選択する必要がある場合にのみ必要です。これは、キャンペーンと広告グループが顧客レベルから住所アセットを継承するためです。
ビジネス グループのアセット セットには、ビジネスの同期アセット セットのビジネス アセットのサブセットが含まれています。Google ビジネス プロフィールの機能(ラベルによるフィルタなど)やチェーン ID、チェーンのビジネス情報を活用して、地域グループのアセットセットを動的に作成できます。また、ロケーショングループのアセットセットを静的に作成することもできます。
- ビジネス グループのアセット セットを作成します。地域グループのアセット セットは、動的または静的にできます。
- 必要に応じて、アセットセットをキャンペーンまたは広告グループに関連付けます。
- (省略可)以前に生成したアセットを、新しく作成した静的ロケーション グループのアセット セットに追加します。
お客様ごとに、複数の動的または静的なビジネス グループ アセットセットを作成できます。
地域グループのアセット セットを作成する
新しい AssetSet
を作成し、location_group_parent_asset_set_id
を以前に作成した住所同期アセット セットの ID に設定します。
次に、動的または静的な地域グループ アセットセットを作成するかどうかに基づいて、いくつかのフィールドを設定します。
動的アセット セット
LocationSet
で設定したフィールドに応じて、次のルールに基づいてフィールドを設定します。
次のフィールドを設定した場合 |
次に、type を |
このフィールドを asset_set_source oneof フィールドとして設定します。 |
business_profile_location_set |
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP |
business_profile_location_group |
chain_location_set |
CHAIN_DYNAMIC_LOCATION_GROUP |
chain_location_group |
住所同期アセット セットの作成時に maps_location_set
を設定すると、動的住所グループのアセット セットを作成できなくなります。これは、場所 ID で場所を手動で追加したため、このタイプの場所に使用できるフィルタリング機能がないためです。
静的アセットセット
type
を STATIC_LOCATION_GROUP
に設定します。LocationSet
で設定したフィールド(business_profile_location_set
、chain_location_set
、maps_location_set
)に関係なく、あらゆるタイプのロケーション同期アセット セットに対して静的ロケーション グループ アセット セットを作成できます。
静的な地域グループのアセット セットの場合は、生成された地域アセットを地域グループのアセット セットに手動で追加する必要があります。
アセットセットをキャンペーンまたは広告グループに関連付ける
CampaignAssetSetService.MutateCampaignAssetSets
を使用して、地域グループ アセットセットをキャンペーンに関連付けます。
代わりに、地域グループ アセット セットを広告グループに関連付ける場合は、AdGroupAssetSetService.MutateAdGroupAssetSets
を使用します。
(省略可)静的な地域グループのアセット セットに地域アセットを追加する
この手順は、以前に静的地域グループ アセット セットを作成した場合にのみ必要です。
asset_set_asset
レポートを使用して、以前に作成したロケーション同期アセット セット用に自動生成されたアセットのリソース名を取得します。フィルタリングを使用して、必要なアセットのみを取得します。
AssetSetAssetService.MutateAssetSetAssets
を使用して、静的地域グループ アセットセットに追加します。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-09-05 UTC。
[null,null,["最終更新日 2025-09-05 UTC。"],[[["\u003cp\u003eLocation assets are automatically created after you create and attach a location sync asset set to the customer.\u003c/p\u003e\n"],["\u003cp\u003eCreate a location sync asset set by defining its type and location source (Business Profile, chain, or manual).\u003c/p\u003e\n"],["\u003cp\u003eIf needed, create a location group asset set (dynamic or static) to select a subset of location assets for a campaign or ad group.\u003c/p\u003e\n"],["\u003cp\u003eDynamic location group asset sets leverage Business Profile or chain features for filtering, while static ones require manual asset addition.\u003c/p\u003e\n"],["\u003cp\u003eAttach the location sync asset set to the customer and, optionally, the location group asset set to a campaign or ad group.\u003c/p\u003e\n"]]],[],null,["# Location assets\n\nUnlike other assets, location assets are automatically created by the Google Ads API\nafter you create an asset set. First, create a location sync asset set and\nattach it to the customer. Then, if you need to select a subset of the location\nassets in the asset set for a campaign or ad group, create a location group\nasset set and attach it to the campaign or ad group.\n\nCreate a location sync asset set and attach it to the customer\n--------------------------------------------------------------\n\n1. [Create a **location sync** asset set](#create-location-sync).\n2. [Attach it to a customer using\n `CustomerAssetSetService`](/google-ads/api/reference/rpc/v21/CustomerAssetSetService).\n\n### Create a location sync asset set\n\n1. Create a new [`AssetSet`](/google-ads/api/reference/rpc/v21/AssetSet).\n 1. Set `type` to [`LOCATION_SYNC`](/google-ads/api/reference/rpc/v21/AssetSetTypeEnum.AssetSetType#location_sync).\n 2. Set `location_set` to a new [`LocationSet`](/google-ads/api/reference/rpc/v21/LocationSet).\n2. In the new `LocationSet`,\n 1. Set `location_ownership_type` based on your use case:\n - Set it to [`BUSINESS_OWNER`](/google-ads/api/reference/rpc/v21/LocationOwnershipTypeEnum.LocationOwnershipType#business_owner) if you own the business location.\n - Set it to [`AFFILIATE`](/google-ads/api/reference/rpc/v21/LocationOwnershipTypeEnum.LocationOwnershipType#affiliate) if you don't own the business location, but sell your products there.\n 2. Set the `source` oneof field based on your use case:\n - Set `business_profile_location_set` if you want to sync with your locations in your [Google Business Profile](//www.google.com/business/) account.\n - Set `chain_location_set` if you want to sync with locations in specified chain IDs.\n - Set `maps_location_set` if you want to manually add locations using [Place IDs](/maps/documentation/places/web-service/place-id).\n\nAfter you complete these steps, the Google Ads API generates **location\nassets** and adds them to the created location sync asset set for you, similar\nto when you manually do so using\n[`AssetSetAssetService`](/google-ads/api/reference/rpc/v21/AssetSetAssetService). You don't need to\nmanipulate them unless you want to manually [add them to a static location\ngroup asset sets](#add-location-assets).\n\nOnly one active location sync asset set with\n([`status`](/google-ads/api/reference/rpc/v21/AssetSet#status) of\n[`ENABLED`](/google-ads/api/reference/rpc/v21/AssetSetStatusEnum.AssetSetStatus#enabled)) can exist\nfor a customer. If you need to create a different type of location sync asset\nset, remove the existing one first.\n\n### Attach the location sync asset set to a customer\n\nUse\n[`CustomerAssetSetService.MutateCustomerAssetSets`](/google-ads/api/reference/rpc/v21/CustomerAssetSetService/MutateCustomerAssetSets)\nto attach the location sync asset set in the previous section to your customer.\n\n(Optional) Create a location group asset set and attach it to a campaign or an ad group\n---------------------------------------------------------------------------------------\n\nA **location group** asset set is necessary only if you need to select a subset\nof location assets. This is due to campaigns and ad groups inheriting location\nassets from the customer level.\n\nLocation group asset sets contain a subset of location assets of the **location\nsync** asset set. You can dynamically create a location group asset set by\nleveraging some features of Google Business Profile (like filtering by labels)\nor chain IDs and chain locations. Alternatively, you can statically create a\nlocation group asset set.\n\n1. [Create a location group asset set](#create-location-group). The location group asset set can be **dynamic** or **static**.\n2. [Attach the asset set to a campaign using or to an ad group, depending on\n your need](#attach-location-group).\n3. [(Optional) Add the previously generated assets to the newly created static\n location group asset set](#add-location-assets).\n\nFor a given customer, you can create multiple dynamic or static location group\nasset sets.\n\n### Create a location group asset set\n\nCreate a new [`AssetSet`](/google-ads/api/reference/rpc/v21/AssetSet) and set\n`location_group_parent_asset_set_id` to the ID of the previously created\nlocation sync asset set.\n\nThen, set some fields based on whether you want to create a dynamic or static\nlocation group asset set.\n\n#### Dynamic asset sets\n\nDepending on the field you [set in `LocationSet`](#create-location-sync), set\nthe fields based on the following rule:\n\n| If you set the following field | Then set [type](/google-ads/api/reference/rpc/v21/AssetSet#type) to | And set this field as the [asset_set_source](/google-ads/api/reference/rpc/v21/AssetSet#asset_set_source) oneof field |\n|---------------------------------|---------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------|\n| `business_profile_location_set` | `BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP` | `business_profile_location_group` |\n| `chain_location_set` | `CHAIN_DYNAMIC_LOCATION_GROUP` | `chain_location_group` |\n\nIf you set `maps_location_set` when [creating the location sync asset\nset](#create-location-sync), you won't be able to create a dynamic location\ngroup asset set. This is because you've manually added locations by Place IDs\nand there are no filtering features you can use for this type of locations.\n\n#### Static asset sets\n\nSet [`type`](/google-ads/api/reference/rpc/v21/AssetSet#type) to\n[`STATIC_LOCATION_GROUP`](/google-ads/api/reference/rpc/v21/AssetSetTypeEnum.AssetSetType#static_location_group).\nYou can create static location group asset sets for any types of location\nsync asset sets, no matter what fields (`business_profile_location_set`,\n`chain_location_set`, or `maps_location_set`) you set in the\n[`LocationSet`](/google-ads/api/reference/rpc/v21/LocationSet#source).\n\nFor **static** location group asset sets, you need to\n[manually add the generated location assets to the location group asset\nsets](#add-location-assets).\n\n### Attach the asset set to a campaign or to an ad group\n\nUse\n[`CampaignAssetSetService.MutateCampaignAssetSets`](/google-ads/api/reference/rpc/v21/CampaignAssetSetService/MutateCampaignAssetSets)\nto attach the [location group asset set](#create-location-group) to your\ncampaign.\n\nAlternatively, use\n[`AdGroupAssetSetService.MutateAdGroupAssetSets`](/google-ads/api/reference/rpc/v21/AdGroupAssetSetService/MutateAdGroupAssetSets)\nif you want to attach the [location group asset set](#create-location-group) to\nan ad group instead.\n\n### (Optional) Add the location assets to the **static** location group asset set\n\nThis step is required only if you create a\n[static location group asset set](#static-asset-sets) previously.\n\n1. Use the [`asset_set_asset`](/google-ads/api/fields/v21/asset_set_asset) report to fetch the resource names of assets automatically generated for the [previously created location sync asset set](#create-location-sync). Use [filtering](/google-ads/api/docs/query/structure#where) to retrieve only the assets you want.\n2. Add them to the [static location group asset set](#static-asset-sets) using [`AssetSetAssetService.MutateAssetSetAssets`](/google-ads/api/reference/rpc/v21/AssetSetAssetService/MutateAssetSetAssets)."]]