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: guaranteedOrders.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt einen neuen Auftrag mit Garantie. Gibt die neu erstellte garantierte Bestellung zurück, wenn der Vorgang erfolgreich war.
HTTP-Anfrage
POST https://displayvideo.googleapis.com/v4/guaranteedOrders
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
| Parameter |
Union-Parameter accessor. Erforderlich. Gibt an, für welche DV360-Entität die Anfrage gestellt wird. Für accessor ist nur einer der folgenden Werte zulässig: |
partnerId |
string (int64 format)
Die ID des Partners, in dessen Kontext die Anfrage gestellt wird.
|
advertiserId |
string (int64 format)
Die ID des Werbetreibenden, in dessen Kontext die Anfrage gestellt wird.
|
Anfragetext
Der Anfragetext enthält eine Instanz von GuaranteedOrder.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von GuaranteedOrder.
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, in beta, allows creating a new guaranteed order via a `POST` request to `https://displayvideo.googleapis.com/v4/guaranteedOrders`. The request requires a specified `accessor` parameter, either `partnerId` or `advertiserId`. The request body should contain a `GuaranteedOrder` instance. Upon success, the API returns the newly created `GuaranteedOrder` in the response body, and requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: guaranteedOrders.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\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 guaranteed order. Returns the newly created guaranteed order if successful.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/guaranteedOrders`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union parameter `accessor`. Required. Identifies which DV360 entity the request is being made within. `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 the request is being made within. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that the request is being made within. |\n\n### Request body\n\nThe request body contains an instance of [GuaranteedOrder](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [GuaranteedOrder](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder).\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)."]]
