يجب أن يوضّح كل عنصر جديد في "عناصر الحملة" ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على صفحة الإيقاف نهائيًا لمزيد من التفاصيل.
تعرض هذه السمة تصميمات الإعلانات الخاصة بأحد المعلِنين.
يتم تحديد الترتيب من خلال المَعلمة orderBy. في حال عدم تحديد filter في entityStatus، لن يتم تضمين التصاميم التي تتضمّن ENTITY_STATUS_ARCHIVED في النتائج.
طلب HTTP
GET https://displayvideo.googleapis.com/v3/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، يمكن أن يكون هناك قيد واحد على الأكثر.
الحقول المتوافقة:
approvalStatus
creativeId
creativeType
dimensions (الإدخال في شكل {width}x{height})
dynamic
entityStatus
exchangeReviewStatus (الإدخال في شكل {exchange}-{reviewStatus})
lineItemIds
maxDuration (الإدخال في شكل {duration}s. يُسمح باستخدام الثواني فقط)
minDuration (الإدخال في شكل {duration}s. يُسمح باستخدام الثواني فقط)
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"
يجب ألا يزيد طول هذا الحقل عن 500 حرف.
يُرجى الرجوع إلى دليل طلبات LISTالفلترة للحصول على مزيد من المعلومات.
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في الطلب اللاحق إلى الطريقة ListCreativesRequest لاسترداد الصفحة التالية من النتائج. إذا كان هذا الحقل فارغًا، يعني ذلك أنّ هذه هي الصفحة الأخيرة.
تاريخ التعديل الأخير: 2025-09-09 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-09 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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\u003eFilter creatives by \u003ccode\u003eapprovalStatus\u003c/code\u003e, \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreativeType\u003c/code\u003e, \u003ccode\u003edimensions\u003c/code\u003e, \u003ccode\u003edynamic\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, \u003ccode\u003eexchangeReviewStatus\u003c/code\u003e, \u003ccode\u003elineItemIds\u003c/code\u003e, \u003ccode\u003emaxDuration\u003c/code\u003e, \u003ccode\u003eminDuration\u003c/code\u003e, or \u003ccode\u003eupdateTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eArchived creatives are excluded unless explicitly filtered for.\u003c/p\u003e\n"],["\u003cp\u003eResults are paginated, with control over page size and retrieval of subsequent pages using tokens.\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"]]],[],null,[]]
