اعتبارًا من
8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على
صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
REST Resource: advertisers.locationLists
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: LocationList
قائمة بالمواقع الجغرافية المستخدَمة للاستهداف
| تمثيل JSON |
{
"name": string,
"locationListId": string,
"displayName": string,
"locationType": enum (TargetingLocationType),
"advertiserId": string
} |
| الحقول |
name |
string
النتائج فقط. اسم المرجع لقائمة المواقع الجغرافية
|
locationListId |
string (int64 format)
النتائج فقط. المعرّف الفريد لقائمة المواقع الجغرافية. تمّ تعيينه من قِبل النظام.
|
displayName |
string
مطلوب. الاسم المعروض لقائمة المواقع الجغرافية. يجب أن يكون بترميز UTF-8 بحد أقصى 240 بايت.
|
locationType |
enum (TargetingLocationType)
مطلوب. غير قابل للتغيير نوع الموقع الجغرافي ستتشارك جميع المواقع الجغرافية في القائمة هذا النوع.
|
advertiserId |
string (int64 format)
مطلوب. غير قابل للتغيير المعرّف الفريد للمعلِن الذي تنتمي إليه قائمة المواقع الجغرافية.
|
TargetingLocationType
نوع الموقع الجغرافي المستهدَف
| عمليات التعداد |
TARGETING_LOCATION_TYPE_UNSPECIFIED |
القيمة التلقائية عندما لا يكون النوع محدّدًا أو غير معروف |
TARGETING_LOCATION_TYPE_PROXIMITY |
نوع الموقع الجغرافي بالقرب |
TARGETING_LOCATION_TYPE_REGIONAL |
نوع الموقع الجغرافي الإقليمي |
الطُرق |
|
|
لإنشاء قائمة مواقع جغرافية جديدة |
|
|
الحصول على قائمة مواقع جغرافية |
|
|
تعرض قوائم المواقع الجغرافية استنادًا إلى رقم تعريف معلن معيّن. |
|
|
تعديل قائمة مواقع |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: advertisers.locationLists\n\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/v4/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/v4/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/v4/advertisers.locationLists/create) | Creates a new location list. |\n| ### [get](/display-video/api/reference/rest/v4/advertisers.locationLists/get) | Gets a location list. |\n| ### [list](/display-video/api/reference/rest/v4/advertisers.locationLists/list) | Lists location lists based on a given advertiser id. |\n| ### [patch](/display-video/api/reference/rest/v4/advertisers.locationLists/patch) | Updates a location list. |"]]
