2025 年 9 月 8 日以降、すべての新しい広告申込情報で、欧州連合(EU)の政治広告を配信するかどうかを宣言する必要があります。宣言が提供されていないディスプレイ&ビデオ 360 API と SDF のアップロードは失敗します。統合を更新してこの宣言を行う方法について詳しくは、
非推奨のページをご覧ください。
REST Resource: advertisers.locationLists
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
リソース: LocationList
JSON 表現 |
{
"name": string,
"locationListId": string,
"displayName": string,
"locationType": enum (TargetingLocationType ),
"advertiserId": string
} |
フィールド |
name |
string
出力専用。ロケーション リストのリソース名。
|
locationListId |
string (int64 format)
出力専用。場所リストの一意の ID。システムによって割り当てられます。
|
displayName |
string
必須。場所リストの表示名。UTF-8 でエンコードし、最大サイズは 240 バイトにする必要があります。
|
locationType |
enum (TargetingLocationType )
必須。変更不可。場所のタイプ。リスト内のすべてのロケーションがこのタイプを共有します。
|
advertiserId |
string (int64 format)
必須。変更不可。地域リストが属する広告主の一意の ID。
|
TargetingLocationType
列挙型 |
TARGETING_LOCATION_TYPE_UNSPECIFIED |
タイプが指定されていない場合や不明な場合のデフォルト値。 |
TARGETING_LOCATION_TYPE_PROXIMITY |
近接地理位置情報のタイプ。 |
TARGETING_LOCATION_TYPE_REGIONAL |
地域の位置情報のタイプ。 |
メソッド |
|
新しい場所リストを作成します。 |
|
場所リストを取得します。 |
|
指定された広告主 ID に基づいて、地域リストを一覧表示します。 |
|
場所リストを更新します。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eLocationList is a resource used for targeting and is a list of locations.\u003c/p\u003e\n"],["\u003cp\u003eEach LocationList has a name, ID, display name, location type, and advertiser ID.\u003c/p\u003e\n"],["\u003cp\u003eThere are three types of targeting location types: unspecified, proximity, and regional.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage LocationLists through methods like creating, getting, listing, and updating them.\u003c/p\u003e\n"]]],["Location lists, used for targeting, are identified by a unique ID and contain a display name, location type (proximity or regional), and the associated advertiser ID. The location type is immutable. Available actions include creating, retrieving (get), listing, and updating (patch) location lists. Each list contains location data with attributes like `name`, `displayName`, `locationType`, and `advertiserId` which is necessary when creating one.\n"],null,["# REST Resource: advertisers.locationLists\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\n- [Resource: LocationList](#LocationList)\n - [JSON representation](#LocationList.SCHEMA_REPRESENTATION)\n- [TargetingLocationType](#TargetingLocationType)\n- [Methods](#METHODS_SUMMARY)\n\nResource: LocationList\n----------------------\n\nA list of locations used for targeting.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"locationListId\": string, \"displayName\": string, \"locationType\": enum (/display-video/api/reference/rest/v3/advertisers.locationLists#TargetingLocationType), \"advertiserId\": string } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The resource name of the location list. |\n| `locationListId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the location list. Assigned by the system. |\n| `displayName` | `string` Required. The display name of the location list. Must be UTF-8 encoded with a maximum size of 240 bytes. |\n| `locationType` | `enum (`[TargetingLocationType](/display-video/api/reference/rest/v3/advertisers.locationLists#TargetingLocationType)`)` Required. Immutable. The type of location. All locations in the list will share this type. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. Immutable. The unique ID of the advertiser the location list belongs to. |\n\nTargetingLocationType\n---------------------\n\nType of a targeting location.\n\n| Enums ||\n|---------------------------------------|---------------------------------------------------------|\n| `TARGETING_LOCATION_TYPE_UNSPECIFIED` | Default value when type is not specified or is unknown. |\n| `TARGETING_LOCATION_TYPE_PROXIMITY` | The type for proximity geo location. |\n| `TARGETING_LOCATION_TYPE_REGIONAL` | The type for regional geo location. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------|------------------------------------------------------|\n| ### [create](/display-video/api/reference/rest/v3/advertisers.locationLists/create) | Creates a new location list. |\n| ### [get](/display-video/api/reference/rest/v3/advertisers.locationLists/get) | Gets a location list. |\n| ### [list](/display-video/api/reference/rest/v3/advertisers.locationLists/list) | Lists location lists based on a given advertiser id. |\n| ### [patch](/display-video/api/reference/rest/v3/advertisers.locationLists/patch) | Updates a location list. |"]]