החל מ-8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין בדף ההוצאה משימוש.
חובה. המזהה של המפרסם שרוצים להציג את הפריטים שלו.
פרמטרים של שאילתה
פרמטרים
pageSize
integer
גודל הדף המבוקש. חייב להיות בין 1 לבין 200. אם לא צוין ערך, ברירת המחדל היא 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת אמור להציג. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת לשיטה lineItems.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
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 by \u003ccode\u003edisplayName\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, or \u003ccode\u003eupdateTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by line item fields such as \u003ccode\u003ecampaignId\u003c/code\u003e, \u003ccode\u003edisplayName\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, \u003ccode\u003einsertionOrderId\u003c/code\u003e, etc.\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\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eGET\u003c/code\u003e request to the endpoint \u003ccode\u003ehttps://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]
