Method: advertisers.insertionOrders.delete
Borra un pedido de inserción. Devuelve el código de error NOT_FOUND
si el pedido de inserción no existe. Primero, se debe archivar el orden de inserción, es decir, establecer entityStatus
en ENTITY_STATUS_ARCHIVED
para poder borrarlo.
Solicitud HTTP
DELETE https://displayvideo.googleapis.com/v3/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)
Es el ID del anunciante al que pertenece este pedido de inserción.
|
insertionOrderId |
string (int64 format)
Es el ID del pedido de inserción que se borrará.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta es un objeto JSON vacío.
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-02-25 (UTC)
[null,null,["Última actualización: 2025-02-25 (UTC)"],[[["Deletes an existing insertion order that has been archived (`ENTITY_STATUS_ARCHIVED`)."],["Requires providing the advertiser ID and the insertion order ID in the request path."],["Uses an HTTP DELETE request with an empty request body to perform the deletion."],["Returns an empty response body upon successful deletion and a `NOT_FOUND` error if the insertion order doesn't exist."],["Needs authorization with the `https://www.googleapis.com/auth/display-video` scope."]]],["To delete an insertion order, send a `DELETE` HTTP request to the specified URL, including the `advertiserId` and `insertionOrderId` as path parameters. The insertion order must be archived beforehand by setting its `entityStatus` to `ENTITY_STATUS_ARCHIVED`. The request body should be empty. A successful deletion returns an empty JSON object. The required authorization scope is `https://www.googleapis.com/auth/display-video`. A `NOT_FOUND` error is returned if the insertion order is not found.\n"]]