اعتبارًا من 8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
مطلوب. رقم تعريف الشريك الذي يجب أن ينتمي إليه جميع المعلِنين الذين تم جلبهم. يتيح النظام عرض بيانات معلِنين عن شريك واحد فقط في كلّ مرّة.
pageSize
integer
حجم الصفحة المطلوب يجب أن تتراوح القيمة بين 1 و200. إذا لم يتم تحديد قيمة، سيتم ضبطها تلقائيًا على 100.
pageToken
string
هو رمز مميز يحدد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة nextPageToken التي تم إرجاعها من الطلب السابق لطريقة advertisers.list. إذا لم يتم تحديدها، سيتم عرض الصفحة الأولى من النتائج.
orderBy
string
الحقل الذي يتم ترتيب القائمة حسبه القيم المقبولة هي:
displayName (تلقائي)
entityStatus
updateTime
يكون ترتيب الفرز التلقائي تصاعديًا. لتحديد ترتيب تنازلي للحقل، يجب استخدام اللاحقة "desc" يجب إضافته إلى اسم الحقل. مثلاً: displayName desc
filter
string
تسمح بالفلترة حسب حقول المعلِن.
بنية متوافقة:
تتألّف عبارات الفلاتر من قيد واحد أو أكثر.
ويمكن دمج القيود من خلال عوامل التشغيل المنطقية AND أو OR.
يكون للقيد {field} {operator} {value}.
يجب أن يستخدم الحقل updateTime عامل التشغيل GREATER THAN OR EQUAL TO (>=) أو LESS THAN OR EQUAL TO (<=).
يجب أن تستخدم جميع الحقول الأخرى عامل التشغيل EQUALS (=).
الحقول المسموح بها:
advertiserId
displayName
entityStatus
updateTime (إدخال بتنسيق ISO 8601 أو YYYY-MM-DDTHH:MM:SSZ)
أمثلة:
جميع المعلِنين النشطين ضمن أحد الشركاء: entityStatus="ENTITY_STATUS_ACTIVE"
جميع المعلِنين الذين لديهم وقت تعديل أقل من أو يساوي 2020-11-04T18:54:47Z (بتنسيق ISO 8601): updateTime<="2020-11-04T18:54:47Z"
جميع المعلِنين الذين لديهم وقت تعديل أكبر من أو يساوي 2020-11-04T18:54:47Z (بتنسيق ISO 8601): updateTime>="2020-11-04T18:54:47Z"
رمز مميّز لاسترداد الصفحة التالية من النتائج مرِّر هذه القيمة في الحقل pageToken في طريقة الاستدعاء التالية إلى advertisers.list لاسترداد الصفحة التالية من النتائج.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis page documents the \u003ccode\u003eadvertisers.list\u003c/code\u003e method, which retrieves a list of advertisers accessible to the current user within Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eAdvertisers are filtered by a required \u003ccode\u003epartnerId\u003c/code\u003e, allowing retrieval of advertisers belonging to a specific partner.\u003c/p\u003e\n"],["\u003cp\u003eResults can be sorted and paginated using query parameters such as \u003ccode\u003eorderBy\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003eAdvertiser\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for accessing subsequent result pages.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details how to list advertisers accessible to a user via the Display & Video 360 API. The core action is sending a `GET` request to `https://displayvideo.googleapis.com/v2/advertisers`. A required `partnerId` parameter specifies the relevant partner. Optional parameters include `pageSize`, `pageToken`, `orderBy` (for sorting), and `filter` for filtering results. The response returns a list of advertisers and a `nextPageToken` for pagination. The request body must be empty, and OAuth 2.0 is used for authorization.\n"],null,[]]
