Ab dem
8. September 2025 muss für jede neue Werbebuchung angegeben werden, ob Werbung mit politischen Inhalten in der Europäischen Union (EU) ausgeliefert wird. Display & Video 360 API- und SDF-Uploads ohne entsprechende Erklärungen schlagen fehl. Weitere Informationen dazu, wie Sie Ihre Integration aktualisieren, um diese Erklärung abzugeben,
finden Sie auf unserer Seite zur Einstellung.
Method: customBiddingAlgorithms.rules.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt eine neue Regelressource. Gibt die neu erstellte Regelnressource zurück, wenn der Vorgang erfolgreich war.
Bei Anfragen zum Erstellen einer Ressource mit Regeln für die benutzerdefinierte Gebotseinstellung unter einem Algorithmus, der einer Werbebuchung zugewiesen ist, wird ein Fehler zurückgegeben.
HTTP-Anfrage
POST https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
customBiddingAlgorithmId |
string (int64 format)
Erforderlich. Die ID des benutzerdefinierten Gebotsalgorithmus, zu dem die Ressourcen mit Regeln gehören.
|
Abfrageparameter
| Parameter |
Union-Parameter owner. Erforderlich. Die DV360-Entität, der der übergeordnete benutzerdefinierte Gebotseinstellungsalgorithmus zugewiesen ist. Es kann sich um einen Partner oder einen Werbetreibenden handeln. Für owner ist nur einer der folgenden Werte zulässig: |
partnerId |
string (int64 format)
Die ID des Partners, dem der übergeordnete benutzerdefinierte Gebotsalgorithmus gehört. Nur dieser Partner hat Schreibzugriff auf diese Ressourcen.
|
advertiserId |
string (int64 format)
Die ID des Werbetreibenden, dem der übergeordnete Algorithmus für benutzerdefinierte Gebote gehört.
|
Anfragetext
Der Anfragetext enthält eine Instanz von CustomBiddingAlgorithmRules.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von CustomBiddingAlgorithmRules.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/display-video
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],["The Display & Video 360 API v4, currently in beta, allows creating new rules resources via a `POST` request to a specified URL. This requires the `customBiddingAlgorithmId` as a path parameter, as well as an `owner` query parameter to define the DV360 entity (partner or advertiser) owning the algorithm. The request body must contain an instance of `CustomBiddingAlgorithmRules`, and a successful request returns the newly created rule instance in the response body. Note that starting April 1, 2025, requests to update custom bidding algorithms assigned to line items will return an error.\n"],null,["# Method: customBiddingAlgorithms.rules.create\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new rules resource. Returns the newly created rules resource if successful.\n\nRequests creating a custom bidding rules resource under an algorithm assigned to a line item will return an error.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules`\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 rules resource. |\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 rules resource. |\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 [CustomBiddingAlgorithmRules](/display-video/api/reference/rest/v4/customBiddingAlgorithms.rules#CustomBiddingAlgorithmRules).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [CustomBiddingAlgorithmRules](/display-video/api/reference/rest/v4/customBiddingAlgorithms.rules#CustomBiddingAlgorithmRules).\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)."]]
