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.
Method: guaranteedOrders.get
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Obtiene un pedido garantizado.
Solicitud HTTP
GET https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
guaranteedOrderId |
string
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: |
partnerId |
string (int64 format)
Es el ID del socio que tiene acceso al pedido garantizado.
|
advertiserId |
string (int64 format)
Es el ID del anunciante que tiene acceso al pedido garantizado.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de GuaranteedOrder.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/display-video
Para obtener más información, consulta OAuth 2.0 Overview.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],["The Display & Video 360 API v4, currently in beta, allows fetching a guaranteed order via a GET request. The request URL includes a required `guaranteedOrderId` path parameter and an `accessor` query parameter that identifies the DV360 entity (either `partnerId` or `advertiserId`) accessing the order. The request body must be empty. Successful requests return a `GuaranteedOrder` instance in the response body and use the scope of `https://www.googleapis.com/auth/display-video`.\n"],null,["# Method: guaranteedOrders.get\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\nGets a guaranteed order.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v4/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/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)."]]
