החל מ-8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין בדף ההוצאה משימוש.
חובה. הסקריפט נמצא בבעלות המזהה של אלגוריתם הבידינג בהתאמה אישית.
פרמטרים של שאילתה
פרמטרים
pageSize
integer
גודל הדף המבוקש. חייב להיות בין 1 לבין 200. אם לא צוין ערך, ברירת המחדל היא 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת אמור להציג. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת לשיטה scripts.list. אם לא יצוין, יוצג דף התוצאות הראשון.
orderBy
string
השדה שלפיו רוצים למיין את הרשימה. הערכים הקבילים הם:
createTime desc (ברירת מחדל)
סדר המיון שמוגדר כברירת מחדל הוא יורד. כדי לציין סדר עולה בשדה, צריך להסיר את הסיומת 'desc'. דוגמה: createTime
פרמטר האיחוד accessor. חובה. מזהה את הישות ב-DV360 שבבעלותה אלגוריתם הבידינג המותאם אישית ברמת ההורה. זה יכול להיות שותף או מפרסם. הערך של accessor יכול להיות רק אחת מהאפשרויות הבאות:
אסימון לאחזור של דף התוצאות הבא. כדי לאחזר את דף התוצאות הבא, מעבירים את הערך הזה בשדה pageToken בקריאה הבאה לשיטה ListCustomBiddingScriptsRequest. אם השדה הזה הוא null, המשמעות היא שזהו הדף האחרון.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],["This API lists custom bidding scripts associated with a specified algorithm using a `GET` request. You must provide the `customBiddingAlgorithmId`. You can filter the results using query parameters like `pageSize`, `pageToken`, and `orderBy`. The `accessor` parameter is required and accepts either a `partnerId` or `advertiserId` for ownership. The response includes a list of `customBiddingScripts` and a `nextPageToken` for pagination. Requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: customBiddingAlgorithms.scripts.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListCustomBiddingScriptsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists custom bidding scripts that belong to the given algorithm.\n\nThe order is defined by the [orderBy](/display-video/api/reference/rest/v4/customBiddingAlgorithms.scripts/list#body.QUERY_PARAMETERS.order_by) parameter.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customBiddingAlgorithmId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the custom bidding algorithm owns the script. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Must be between `1` and `200`. If unspecified will default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [nextPageToken](/display-video/api/reference/rest/v4/customBiddingAlgorithms.scripts/list#body.ListCustomBiddingScriptsResponse.FIELDS.next_page_token) returned from the previous call to `scripts.list` method. If not specified, the first page of results will be returned. |\n| `orderBy` | `string` Field by which to sort the list. Acceptable values are: - `createTime desc` (default) The default sorting order is descending. To specify ascending order for a field, the suffix \"desc\" should be removed. Example: `createTime`. |\n| Union parameter `accessor`. Required. Identifies the DV360 entity that owns the parent custom bidding algorithm. It can be either a partner or an advertiser. `accessor` can be only one of the following: ||\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that owns the parent custom bidding algorithm. Only this partner will have write access to this custom bidding script. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the parent custom bidding algorithm. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"customBiddingScripts\": [ { object (/display-video/api/reference/rest/v4/customBiddingAlgorithms.scripts#CustomBiddingScript) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customBiddingScripts[]` | `object (`[CustomBiddingScript](/display-video/api/reference/rest/v4/customBiddingAlgorithms.scripts#CustomBiddingScript)`)` The list of custom bidding scripts. This list will be absent if empty. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [pageToken](/display-video/api/reference/rest/v4/customBiddingAlgorithms.scripts/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to `ListCustomBiddingScriptsRequest` method to retrieve the next page of results. If this field is null, it means this is the last page. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
