בכל פריט חדש להזמנת שטחי פרסום צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. לפרטים נוספים אפשר לעיין בדף ההוצאות משימוש.
חובה. המזהה של המפרסם שרוצים להציג את הזמנות הקמפיין שלו.
פרמטרים של שאילתה
פרמטרים
pageSize
integer
גודל הדף המבוקש. חייב להיות בין 1 לבין 100. אם לא מציינים ערך, ברירת המחדל היא 100. מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמזהה איזה דף תוצאות השרת צריך להחזיר. בדרך כלל זה הערך של nextPageToken שמוחזר מהקריאה הקודמת לשיטת insertionOrders.list. אם לא מציינים ערך, יוצג דף התוצאות הראשון.
orderBy
string
השדה שלפיו רוצים למיין את הרשימה. ערכים קבילים:
"displayName" (ברירת מחדל)
"entityStatus"
"updateTime"
סדר המיון שמוגדר כברירת מחדל הוא סדר עולה. כדי לציין סדר יורד בשדה, צריך להוסיף את הסיומת 'desc' לשם השדה. דוגמה: displayName desc
filter
string
מאפשר סינון לפי שדות של סדר ההוספה.
תחביר נתמך:
ביטויי סינון מורכבים מהגבלה אחת או יותר.
אפשר לשלב בין הגבלות באמצעות האופרטורים הלוגיים AND או OR. רצף של הגבלות משתמש באופן מרומז ב-AND.
ההגבלות הן בפורמט {field} {operator} {value}.
בשדה updateTime צריך להשתמש באופרטורים GREATER THAN OR EQUAL TO (>=) או LESS THAN OR EQUAL TO (<=).
בכל שאר השדות צריך להשתמש באופרטור EQUALS (=).
שדות נתמכים:
campaignId
displayName
entityStatus
updateTime (קלט בפורמט ISO 8601 או YYYY-MM-DDTHH:MM:SSZ)
דוגמאות:
כל הזמנות הקמפיין בקמפיין: campaignId="1234"
כל הזמנות הקמפיין ENTITY_STATUS_ACTIVE או ENTITY_STATUS_PAUSED שמשויכות למפרסם: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED")
כל הזמנות הפרסום עם שעת עדכון שמוקדמת לתאריך 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"
[[["התוכן קל להבנה","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-10 (שעון UTC)."],[[["\u003cp\u003eLists insertion orders, filterable by campaign ID, display name, entity status, and update time, within a specified advertiser.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large result sets via \u003ccode\u003epageToken\u003c/code\u003e and \u003ccode\u003epageSize\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eAllows sorting results by display name, entity status, or update time, with optional descending order.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides a list of insertion orders and a token for fetching the next page if available.\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 API endpoint lists insertion orders for a specified advertiser using a GET request. You must provide the `advertiserId` as a path parameter. You can filter the results using the `filter` query parameter, sort them using `orderBy`, and control pagination with `pageSize` and `pageToken`. The response includes a list of `insertionOrders` and a `nextPageToken` for pagination. Filtering allows for logical operators and various fields, including `entityStatus` and `updateTime`. The request body must be empty.\n"],null,[]]
