Starting September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details on how to update your integration to make this declaration.
Required. The ID of the custom bidding algorithm that owns the script.
Query parameters
Parameters
Union parameter owner. Required. Identifies the DV360 entity that owns the parent custom bidding algorithm. It can be either a partner or an advertiser. owner can be only one of the following:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eDisplay & Video 360 API v2 is sunset and this document outlines the creation of new custom bidding scripts using the API.\u003c/p\u003e\n"],["\u003cp\u003eThe API request utilizes an HTTP POST method to a specific endpoint with path and query parameters defining the script ownership and parent algorithm.\u003c/p\u003e\n"],["\u003cp\u003eBoth request and response bodies involve a \u003ccode\u003eCustomBiddingScript\u003c/code\u003e object for data exchange regarding the script details.\u003c/p\u003e\n"],["\u003cp\u003eProper authorization using the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope is required for successful API interaction.\u003c/p\u003e\n"]]],["This documentation details the process for creating a new custom bidding script via the Display & Video API. It uses a `POST` request to the specified URL, including the required `customBiddingAlgorithmId`. The request must identify the owning DV360 entity using either `partnerId` or `advertiserId` as a query parameter. The request body must contain a `CustomBiddingScript` instance. A successful request returns the newly created `CustomBiddingScript` instance in the response body and requires the `https://www.googleapis.com/auth/display-video` authorization scope.\n"],null,["# Method: customBiddingAlgorithms.scripts.create\n\n| Display \\& Video 360 API v2 has sunset.\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new custom bidding script. Returns the newly created script if successful.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v2/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 that owns the script. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union parameter `owner`. Required. Identifies the DV360 entity that owns the parent custom bidding algorithm. It can be either a partner or an advertiser. `owner` 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 contains an instance of [CustomBiddingScript](/display-video/api/reference/rest/v2/customBiddingAlgorithms.scripts#CustomBiddingScript).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [CustomBiddingScript](/display-video/api/reference/rest/v2/customBiddingAlgorithms.scripts#CustomBiddingScript).\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](https://developers.google.com/identity/protocols/OAuth2)."]]
