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: advertisers.insertionOrders.get
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Obtiene un pedido de inserción. Devuelve el código de error NOT_FOUND si el pedido de inserción no existe.
Solicitud HTTP
GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
advertiserId |
string (int64 format)
Obligatorio. Es el ID del anunciante al que pertenece este pedido de inserción.
|
insertionOrderId |
string (int64 format)
Obligatorio. Es el ID del pedido de inserción que se recuperará.
|
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 InsertionOrder.
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 (beta) uses a `GET` request to retrieve an insertion order. The request URL includes `advertiserId` and `insertionOrderId` as required path parameters. The request body must be empty. A successful response returns an `InsertionOrder` instance. If the order does not exist it returns a `NOT_FOUND` error. The authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: advertisers.insertionOrders.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_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 an insertion order. Returns error code `NOT_FOUND` if the insertion order does not exist.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the advertiser this insertion order belongs to. |\n| `insertionOrderId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the insertion order to fetch. |\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 [InsertionOrder](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrder).\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)."]]
