2025 年 9 月 8 日以降、すべての新しい広告申込情報で、欧州連合(EU)の政治広告を配信するかどうかを宣言する必要があります。宣言が提供されていないディスプレイ&ビデオ 360 API と SDF のアップロードは失敗します。統合を更新してこの宣言を行う方法について詳しくは、
非推奨のページをご覧ください。
Method: advertisers.insertionOrders.delete
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
広告掲載オーダーを削除します。広告掲載オーダーが存在しない場合、エラーコード NOT_FOUND
を返します。広告掲載オーダーを削除するには、まずアーカイブする必要があります。つまり、entityStatus
を ENTITY_STATUS_ARCHIVED
に設定する必要があります。
HTTP リクエスト
DELETE https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
advertiserId |
string (int64 format)
この広告掲載オーダーが属する広告主の ID。
|
insertionOrderId |
string (int64 format)
削除する広告掲載オーダーの ID。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文は空の JSON オブジェクトになります。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/display-video
詳細については、OAuth 2.0 Overview をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],["The Display & Video 360 API v4 allows the deletion of insertion orders via a `DELETE` HTTP request. The request URL requires `advertiserId` and `insertionOrderId` path parameters. Before deletion, the insertion order's `entityStatus` must be set to `ENTITY_STATUS_ARCHIVED`. The request body should be empty. A successful deletion returns an empty JSON object. If the insertion order is not found, a `NOT_FOUND` error code is returned. This operation requires the `https://www.googleapis.com/auth/display-video` authorization scope.\n"],null,["# Method: advertisers.insertionOrders.delete\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\nDeletes an insertion order. Returns error code `NOT_FOUND` if the insertion order does not exist. The insertion order should be archived first, i.e. set [entityStatus](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrder.FIELDS.entity_status) to `ENTITY_STATUS_ARCHIVED`, to be able to delete it.\n\n### HTTP request\n\n`DELETE 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)` The ID of the advertiser this insertion order belongs to. |\n| `insertionOrderId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the insertion order to delete. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\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)."]]