החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
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
טיפוסים בני מנייה (enum) |
TARGETING_LOCATION_TYPE_UNSPECIFIED |
ערך ברירת המחדל כשהסוג לא צוין או לא ידוע. |
TARGETING_LOCATION_TYPE_PROXIMITY |
הסוג של המיקום הגיאוגרפי הקרוב. |
TARGETING_LOCATION_TYPE_REGIONAL |
הסוג של המיקום הגיאוגרפי האזורי. |
Methods |
|
יצירת רשימת מיקומים חדשה. |
|
הפונקציה מקבלת רשימת מיקומים. |
|
הצגת רשימות של מיקומים על סמך מזהה מפרסם נתון. |
|
עדכון של רשימת מיקומים. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],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. |"]]