اعتبارًا من 8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
يتم تحديد الترتيب من خلال المَعلمة orderBy. إذا لم يتم تحديد filter في entityStatus، لن يتم تضمين تصميمات الإعلانات التي تحتوي على ENTITY_STATUS_ARCHIVED في النتائج.
طلب HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/creatives
مطلوب. الرقم التعريفي للمعلِن المطلوب إدراج تصميمات إعلانات له
معامِلات طلب البحث
المعلمات
pageSize
integer
حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 1 و200. وفي حال عدم تحديد قيمة، سيتم ضبط القيمة تلقائيًا على "100". تعرض رمز الخطأ INVALID_ARGUMENT إذا تم تحديد قيمة غير صالحة.
pageToken
string
هو رمز مميز يحدد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة nextPageToken التي يتم عرضها من الاستدعاء السابق لطريقة creatives.list. وفي حال عدم تحديده، سيتم عرض الصفحة الأولى من النتائج.
orderBy
string
الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
creativeId (تلقائي)
createTime
mediaDuration
dimensions (الترتيب حسب العرض أولاً، ثم حسب الارتفاع)
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي للحقل، يجب استخدام اللاحقة "desc" يجب إضافته إلى اسم الحقل. مثال: createTime desc
filter
string
تسمح بالفلترة حسب حقول تصميمات الإعلانات.
بنية متوافقة:
تتكون تعبيرات الفلاتر من قيد واحد أو أكثر.
ويمكن دمج القيود من خلال عوامل التشغيل المنطقية AND أو OR. سلسلة من القيود تستخدم ضمنيًا AND.
يكون للقيد {field} {operator} {value}.
يجب أن يستخدم الحقل lineItemIds عامل التشغيل HAS (:).
يجب أن يستخدم الحقل updateTime عامل التشغيل GREATER THAN OR EQUAL TO (>=) أو LESS THAN OR EQUAL TO (<=).
ويجب أن تستخدم جميع الحقول الأخرى عامل التشغيل EQUALS (=).
بالنسبة إلى الحقول entityStatus وminDuration وmaxDuration وupdateTime وdynamic، قد يكون هناك قيد واحد على الأكثر.
updateTime (إدخال بتنسيق ISO 8601 أو YYYY-MM-DDTHH:MM:SSZ)
ملاحظات:
بالنسبة إلى updateTime، تعكس قيمة حقل مورد تصميم الإعلان آخر مرة تمّ فيها تعديل تصميم إعلان، والذي يتضمّن التعديلات التي أجراها النظام (مثل تعديلات مراجعة تصميمات الإعلانات).
أمثلة:
جميع تصميمات الإعلانات المدمجة مع المحتوى: creativeType="CREATIVE_TYPE_NATIVE"
جميع تصميمات الإعلانات النشطة بالأبعاد 300x400 أو 50x100: entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400"
OR dimensions="50x100")
كل تصاميم الإعلانات الديناميكية التي تمت الموافقة عليها من قِبل AdX أو AppNexus، بحيث تكون مدتها 5 ثوانٍ و200 ملي ثانية على الأقل: dynamic="true" AND minDuration="5.2s" AND
(exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED"
OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")
جميع تصميمات إعلانات الفيديو المرتبطة بمعرّف العنصر 1 أو 2: creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR lineItemIds:2)
البحث عن تصميمات إعلانات حسب أرقام تعريف تصميمات إعلانات متعددة: creativeId=1 OR creativeId=2
جميع تصميمات الإعلانات التي يزيد وقت تحديثها عن أو يساوي 2020-11-04T18:54:47Z (بتنسيق ISO 8601): updateTime>="2020-11-04T18:54:47Z"
رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في طريقة الاستدعاء التالية إلى ListCreativesRequest لاسترداد الصفحة التالية من النتائج. إذا كان هذا الحقل خاليًا، فهذا يعني أن هذه هي الصفحة الأخيرة.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLists creatives, ordered by \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreateTime\u003c/code\u003e, \u003ccode\u003emediaDuration\u003c/code\u003e, or \u003ccode\u003edimensions\u003c/code\u003e, for a given advertiser.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by creative fields like \u003ccode\u003eapprovalStatus\u003c/code\u003e, \u003ccode\u003ecreativeType\u003c/code\u003e, \u003ccode\u003edimensions\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, and more using the \u003ccode\u003efilter\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eProvides pagination using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e to retrieve large result sets.\u003c/p\u003e\n"],["\u003cp\u003eExcludes creatives with \u003ccode\u003eENTITY_STATUS_ARCHIVED\u003c/code\u003e status unless explicitly filtered for.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This content details how to use the `creatives.list` method to retrieve a list of creatives for a specific advertiser via the Display & Video API. Key actions involve sending a `GET` HTTP request to the provided URL with the advertiser ID. You can refine the results using query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter`. The response includes a list of creatives and a `nextPageToken` for pagination. Requests require OAuth authorization with the `display-video` scope. The request body should be empty.\n"],null,[]]
