החל מ-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, display name, or the accessing DV360 entity (partner or advertiser).\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e to retrieve large result sets.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document outlines how to list custom bidding algorithms accessible to a user via the Display & Video 360 API. A `GET` request to `https://displayvideo.googleapis.com/v2/customBiddingAlgorithms` is used, with parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` controlling results. The `accessor` parameter, either `partnerId` or `advertiserId`, specifies the DV360 entity. The empty request body returns a response containing a list of `customBiddingAlgorithms` and a `nextPageToken` for pagination. Access requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,[]]
