החל מ-8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין בדף ההוצאה משימוש.
חובה. המזהה של המפרסם שעבורו יש להציג רשימה של פריטים.
פרמטרים של שאילתה
פרמטרים
pageSize
integer
גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם לא צויין ערך, ברירת המחדל תהיה 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method lineItems.list. אם לא מציינים זאת, המערכת תחזיר את דף התוצאות הראשון.
orderBy
string
השדה שלפיו צריך למיין את הרשימה. הערכים הקבילים הם:
displayName (ברירת מחדל)
entityStatus
updateTime
ברירת המחדל של סדר המיון היא בסדר עולה. כדי לציין סדר יורד בשדה, הסיומת 'תיאור' יש להוסיף לשם השדה. דוגמה: 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
insertionOrderId
lineItemId
lineItemType
updateTime (קלט בפורמט ISO 8601 או YYYY-MM-DDTHH:MM:SSZ)
דוגמאות:
כל הפריטים בהזמנת קמפיין: insertionOrderId="1234"
כל הפריטים ENTITY_STATUS_ACTIVE או ENTITY_STATUS_PAUSED וגם LINE_ITEM_TYPE_DISPLAY_DEFAULT תחת מפרסם: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED") AND
lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
כל הפריטים שזמן העדכון שלהם נמוך מ-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"
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eLists line items within a specified advertiser, ordered and filtered according to parameters like \u003ccode\u003eorderBy\u003c/code\u003e and \u003ccode\u003efilter\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for retrieving large result sets.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by fields such as \u003ccode\u003ecampaignId\u003c/code\u003e, \u003ccode\u003edisplayName\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, \u003ccode\u003einsertionOrderId\u003c/code\u003e, \u003ccode\u003elineItemId\u003c/code\u003e, \u003ccode\u003elineItemType\u003c/code\u003e, and \u003ccode\u003eupdateTime\u003c/code\u003e.\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"],["\u003cp\u003eReturns a list of line items and a token for retrieving the next page of results, if available.\u003c/p\u003e\n"]]],["This content details how to list line items within an advertiser using the Display & Video 360 API. It involves sending a `GET` request to a specific URL, including the `advertiserId` as a path parameter. Optional query parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` to control the results' pagination, sorting, and filtering. The response includes a list of `lineItems` and a `nextPageToken` for retrieving further pages. Authorization requires the `https://www.googleapis.com/auth/display-video` scope.\n"],null,[]]
