تعرض هذه الطريقة قوائم المواقع الجغرافية استنادًا إلى رقم تعريف معلِن معيّن.
طلب HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/locationLists
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
المعلمات | |
---|---|
advertiserId |
الحقل مطلوب. رقم تعريف المعلِن على "مساحة العرض والفيديو 360" الذي تنتمي إليه قوائم المواقع الجغرافية التي تمّ استرجاعها. |
مَعلمات طلب البحث
المعلمات | |
---|---|
pageSize |
حجم الصفحة المطلوب يجب أن تتراوح القيمة بين |
pageToken |
رمز مميّز يحدّد صفحة من النتائج التي يجب أن يعرضها الخادم. عادةً، تكون هذه القيمة هي قيمة |
orderBy |
الحقل الذي سيتم ترتيب القائمة حسبه القيم المقبولة هي:
يكون ترتيب الفرز التلقائي تصاعديًا. لتحديد ترتيب تنازلي لحقل معيّن، يجب إضافة اللاحقة "desc" إلى اسم الحقل. مثال: |
filter |
تتيح هذه السمة الفلترة حسب حقول قائمة المواقع الجغرافية. بنية الجملة المتوافقة:
الحقول المتاحة:
أمثلة:
يجب ألا يزيد طول هذا الحقل عن 500 حرف. يُرجى الرجوع إلى دليل طلبات |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"locationLists": [
{
object ( |
الحقول | |
---|---|
locationLists[] |
قائمة قوائم المواقع الجغرافية لن تظهر هذه القائمة إذا كانت فارغة. |
nextPageToken |
رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.