בכל פריט חדש להזמנת שטחי פרסום צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. לפרטים נוספים אפשר לעיין בדף ההוצאות משימוש.
חובה. המזהה של המפרסם שרוצים להציג את הקריאייטיבים שלו.
פרמטרים של שאילתה
פרמטרים
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"
אסימון לאחזור של דף התוצאות הבא. מעבירים את הערך הזה בשדה pageToken בקריאה הבאה לשיטה ListCreativesRequest כדי לאחזר את דף התוצאות הבא. אם השדה הזה הוא null, המשמעות היא שזה הדף האחרון.
[[["התוכן קל להבנה","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 (שעון UTC)."],[[["\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,[]]
