Yahoo!広告 検索広告 API v17 リリースノート

リリースバージョン

v17

リリース日

2025年6月30日(月)

本リリースの主な内容

※オブジェクトなどの詳細は、リファレンスをご確認ください。

1. 「広告表示アセットの削除機能」に対応

広告表示アセットの削除機能に対応しました。実際に利用可能になるのは機能のリリース後を予定しています。
提供スケジュールや機能の詳細は、以下のお知らせを参照してください。
広告表示アセットの削除機能追加について

対象ウェブサービス

AssetService

変更内容

AssetServiceに「/remove」を追加します。
※v15およびv16にも追加されます。

サンプルリクエストおよびレスポンス例

■サンプルリクエスト

{
  "accountId": 111,
  "operand": [
    {
      "assetId": 1111
    },
    {
      "assetId": 2222
    }
  ]
}

■レスポンス例

※addまたはsetで返却される内容と同一です。

{
  "errors": null,
  "rid": "rid0000",
  "rval": {
    "values": [
      {
        "errors": null,
        "asset": {
          "accountId": 111,
          "assetId": 1111,
          "assetData": {
            // Assetの詳細に関するデータ
          },
          // 省略
        },
        "operationSucceeded": true
      }, ...
      // 複数削除した場合は複数返却されます
    ]
  }
}

2. 保守改善

  • ConversionGroupService/setでconversionTrackers[]、conversionTrackerId、およびconversionGroupNameが任意になりました。
    提供中の全バージョンが対象です。
  • 今後の機能追加のため、以下のウェブサービスに項目を追加しました。実際に利用可能になるのは機能のリリース後となります。
    利用開始時期などの詳細は別途お知らせいたします。
    AccountService、AccountManagementService、SsaAccountService 、BudgetOrderService
  • Java用クライアントライブラリで提供している「*-spring5」とsuffixがついたリリースバージョンは、v17でサポートを終了します。

v16とv17のIF差分

こちらのページで検索広告 API v16とv17の差分をIF単位でご覧いただけます。

検索広告 APIの提供終了バージョンについて

以下の日程で検索広告 API v15の提供を終了します。

  • サポート終了日:2025年7月28日(月)
  • システム終了日:2025年11月上旬(予定)
    ※日程が決まり次第お知らせいたします。

また、検索広告 API v14を以下の日程で終了します。

  • システム終了日:2025年7月28日(月)
    ※サポートは終了済みです。