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.patch
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Actualiza un pedido de inserción existente. Devuelve el pedido de inserción actualizado si se realiza correctamente.
Solicitud HTTP
PATCH https://displayvideo.googleapis.com/v4/advertisers/{insertionOrder.advertiserId}/insertionOrders/{insertionOrder.insertionOrderId}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
insertionOrder.advertiserId |
string (int64 format)
Solo salida. Es el ID único del anunciante al que pertenece el pedido de inserción.
|
insertionOrder.insertionOrderId |
string (int64 format)
Solo salida. El ID único del pedido de inserción. El sistema lo asigna.
|
Parámetros de consulta
| Parámetros |
updateMask |
string (FieldMask format)
Obligatorio. La máscara para controlar qué campos se actualizarán. Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de InsertionOrder.
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)"],[],[],null,["# Method: advertisers.insertionOrders.patch\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\nUpdates an existing insertion order. Returns the updated insertion order if successful.\n\n### HTTP request\n\n`PATCH https://displayvideo.googleapis.com/v4/advertisers/{insertionOrder.advertiserId}/insertionOrders/{insertionOrder.insertionOrderId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `insertionOrder.advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the advertiser the insertion order belongs to. |\n| `insertionOrder.insertionOrderId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the insertion order. Assigned by the system. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. The mask to control which fields to update. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [InsertionOrder](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrder).\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)."]]
