A partir del 8 de septiembre de 2025, cada elemento de la línea nuevo deberá declarar si publicará anuncios políticos de la Unión Europea (UE). Las cargas de la API de Display & Video 360 y del SDF que no proporcionen declaraciones fallarán. Consulta nuestra página de bajas para obtener más detalles sobre cómo actualizar tu integración y realizar esta declaración.
Obligatorio. Es el ID del pedido garantizado que se recuperará.
El ID tiene el formato {exchange}-{legacyGuaranteedOrderId}.
Parámetros de consulta
Parámetros
Parámetro de unión accessor. Obligatorio.
Identifica en qué entidad de DV360 se realiza la solicitud. La solicitud GET solo mostrará el pedido garantizado al que puede acceder la entidad de DV360 identificada en accessor. Las direcciones (accessor) solo pueden ser una de las siguientes opciones:
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eRetrieves a specific guaranteed order using its unique identifier, formatted as \u003ccode\u003e{exchange}-{legacyGuaranteedOrderId}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying an \u003ccode\u003eaccessor\u003c/code\u003e in the query parameters to identify the DV360 entity (partner or advertiser) with access to the order.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful response returns a \u003ccode\u003eGuaranteedOrder\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details how to retrieve a guaranteed order using a GET request. The request URL structure includes `guaranteedOrderId` as a required path parameter, formatted as `{exchange}-{legacyGuaranteedOrderId}`. A required query parameter, `accessor`, specifies either a `partnerId` or `advertiserId` to define the DV360 entity. The request body must be empty. Upon success, the response body contains a `GuaranteedOrder` instance. Access requires the `https://www.googleapis.com/auth/display-video` authorization scope.\n"],null,["# Method: guaranteedOrders.get\n\n| Display \\& Video 360 API is deprecated and will sunset on **October 7, 2025** . Migrate to [Display \\& Video 360 API v4](/display-video/api/reference/rest/v4) before sunset to avoid an interruption in service.\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\nGets a guaranteed order.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v3/guaranteedOrders/{guaranteedOrderId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------|\n| `guaranteedOrderId` | `string` Required. The ID of the guaranteed order to fetch. The ID is of the format `{exchange}-{legacyGuaranteedOrderId}` |\n\n### Query parameters\n\n| Parameters ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Union parameter `accessor`. Required. Identifies which DV360 entity the request is being made within. The GET request will only return guaranteed order that is accessible to the DV360 entity identified within the `accessor`. `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 has access to the guaranteed order. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that has access to the guaranteed order. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [GuaranteedOrder](/display-video/api/reference/rest/v3/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)."]]
