החל מ-8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין בדף ההוצאה משימוש.
גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם לא צויין ערך, ברירת המחדל תהיה 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method customBiddingAlgorithms.list. אם לא מציינים זאת, המערכת תחזיר את דף התוצאות הראשון.
orderBy
string
השדה שלפיו צריך למיין את הרשימה. הערכים הקבילים הם:
displayName (ברירת מחדל)
ברירת המחדל של סדר המיון היא בסדר עולה. כדי לציין סדר יורד בשדה, הסיומת 'תיאור' יש להוסיף לשם השדה. דוגמה: displayName desc
filter
string
מאפשר סינון לפי שדות אלגוריתם של בידינג בהתאמה אישית.
תחביר נתמך:
ביטויי הסינון מורכבים מהגבלה אחת או יותר.
אפשר לשלב את ההגבלות עד AND. רצף של הגבלות משתמש באופן מרומז ב-AND.
הגבלה היא בפורמט {field} {operator} {value}.
השדה customBiddingAlgorithmType חייב להשתמש באופרטור EQUALS (=).
השדה displayName חייב להשתמש באופרטור HAS (:).
שדות נתמכים:
customBiddingAlgorithmType
displayName
דוגמאות:
כל האלגוריתמים של בידינג בהתאמה אישית שהשם המוצג שלהם מכיל את המילה 'פוליטיקה': displayName:"politics".
כל האלגוריתמים של בידינג בהתאמה אישית שהסוג שלהם הוא "script_BASED": customBiddingAlgorithmType=SCRIPT_BASED
פרמטר האיחוד accessor. חובה. מציינת באיזו ישות ב-DV360 הבקשה נשלחת. הבקשה LIST תחזיר רק ישויות אלגוריתמיות של בידינג בהתאמה אישית שניתן לגשת אליהן לישות ב-DV360 שצוינה ב-accessor. כדי לבצע בקשת LIST, למשתמש צריכה להיות הרשאה לישות accessor. accessor יכול להיות רק אחת מהאפשרויות הבאות:
אסימון לאחזור של דף התוצאות הבא. צריך להעביר את הערך הזה בשדה pageToken בקריאה הבאה לשיטה ListCustomBiddingAlgorithmsRequest, כדי לאחזר את דף התוצאות הבא. אם השדה הזה הוא null, המשמעות היא שזהו הדף האחרון.
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eLists custom bidding algorithms accessible to the current user for bidding strategies, ordered by the \u003ccode\u003eorderBy\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by algorithm type and display name using the \u003ccode\u003efilter\u003c/code\u003e parameter, with a maximum length of 500 characters.\u003c/p\u003e\n"],["\u003cp\u003eSpecify \u003ccode\u003epageSize\u003c/code\u003e (1-200, default 100) and use \u003ccode\u003epageToken\u003c/code\u003e for pagination through results.\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\u003eDisplay & Video 360 API v1 has been sunset.\u003c/p\u003e\n"]]],["This document outlines the process for listing custom bidding algorithms via the Display & Video 360 API. Key actions involve sending a `GET` request to `https://displayvideo.googleapis.com/v1/customBiddingAlgorithms`. Users can specify `pageSize`, `pageToken`, `orderBy`, and `filter` in the query parameters. The `accessor` parameter is required and it identifies which entity is the request being made within. The response returns a list of custom bidding algorithms and a `nextPageToken` for pagination, if applicable, adhering to specific authorization scopes.\n"],null,[]]
