החל מ-8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין בדף ההוצאה משימוש.
חובה. המזהה של הפריט שעבורו הוקצו אפשרויות טירגוט.
פרמטרים של שאילתה
פרמטרים
pageSize
integer
גודל הדף המבוקש. הגודל חייב להיות מספר שלם בין 1 ל-5000. אם לא צוין אחרת, ברירת המחדל היא 5000. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמאפשר ללקוח לאחזר את דף התוצאות הבא. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method lineItems.bulkListLineItemAssignedTargetingOptions. אם לא מציינים זאת, המערכת תחזיר את דף התוצאות הראשון.
orderBy
string
השדה שלפיו צריך למיין את הרשימה. הערכים הקבילים הם:
targetingType (ברירת מחדל)
ברירת המחדל של סדר המיון היא בסדר עולה. כדי לציין סדר יורד בשדה, הסיומת 'תיאור' יש להוסיף לשם השדה. דוגמה: targetingType desc
filter
string
מאפשר סינון לפי שדות של אפשרויות טירגוט שהוקצו.
תחביר נתמך:
ביטויי הסינון מורכבים מהגבלה אחת או יותר.
אפשר לשלב הגבלות באמצעות האופרטור הלוגי OR.
הגבלה היא בפורמט {field} {operator} {value}.
צריך להשתמש באופרטור EQUALS (=) בכל השדות.
שדות נתמכים:
targetingType
inheritance
דוגמאות:
AssignedTargetingOption משאבים מסוג הטירגוט TARGETING_TYPE_PROXIMITY_LOCATION_LIST או TARGETING_TYPE_CHANNEL: targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR
targetingType="TARGETING_TYPE_CHANNEL"
AssignedTargetingOption משאבים עם סטטוס ירושה של NOT_INHERITED או INHERITED_FROM_PARTNER: inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"
אסימון שמזהה את דף התוצאות הבא. יש לציין את הערך הזה בתור pageToken ב-BulkListLineItemAssignedTargetingOptionsRequest שלאחר מכן כדי לאחזר את דף התוצאות הבא. האסימון הזה לא יופיע אם לא יהיו יותר assignedTargetingOptions החזרה.
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eLists assigned targeting options for a given line item, including details like targeting type and inheritance status.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large result sets using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering results based on \u003ccode\u003etargetingType\u003c/code\u003e and \u003ccode\u003einheritance\u003c/code\u003e using the \u003ccode\u003efilter\u003c/code\u003e parameter.\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\u003eEmploys a \u003ccode\u003eGET\u003c/code\u003e request to the specified endpoint with advertiser and line item IDs as path parameters.\u003c/p\u003e\n"]]],["This API endpoint retrieves a list of assigned targeting options for a specific line item within an advertiser's account. Key actions include sending a `GET` request to the specified URL, using `advertiserId` and `lineItemId` as path parameters. Optional query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` can be used to customize the results. The API returns a list of `assignedTargetingOptions` and a `nextPageToken` for paginating through results, requiring the `display-video` authorization scope.\n"],null,[]]
