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 تمثّل هذه السمة نوع الموقع الجغرافي الإقليمي.

الطُرق

create

تنشئ هذه الطريقة قائمة مواقع جغرافية جديدة.

get

تعرض هذه الطريقة قائمة مواقع.

list

تعرض هذه الطريقة قوائم المواقع الجغرافية استنادًا إلى رقم تعريف معلِن معيّن.

patch

تعديل قائمة مواقع