Yahoo! JAPAN Ads API | Developer Center

Yahoo! JAPAN Ads Search Ads API v17 Release Note

Version released

v17

Date

June 30, 2025

Key points of this release

*More about objects and other details are described in the reference document.

1. Ad display asset removal feature

We support the ad display asset remove feature. You can use this feature only after the release.
See the following announcement for details.
Ad display asset removal feature

Services
AssetService

Changes
Add "/remove" to AssetService.
*We will apply this addition to v15 and v16.

Sample request and response example

■Sample request

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

■Response example

*The content returned is the same as with add or set.

{
  "errors": null,
  "rid": "rid0000",
  "rval": {
    "values": [
      {
        "errors": null,
        "asset": {
          "accountId": 111,
          "assetId": 1111,
          "assetData": {
            // Data related to asset details
          },
          // Omitted
        },
        "operationSucceeded": true
      }
      // Multiple entries will be returned if multiple assets are removed
    ]
  }
}

2. Maintenance

• In ConversionGroupService/set, conversionTrackers[], conversionTrackerId, and conversionGroupName are now optional. All available versions
• For future feature additions, we have added items to the following web services. You can use the features only after the release. We will make an announcement once details have been decided.
  AccountService, AccountManagementService, SsaAccountService, BudgetOrderService
• In the Java client library, release versions with the suffix "-spring5" will no longer be supported as of v17.

Differences between v16 and v17 IF

You can view the differences between Search Ads API v16 and v17 on this page, organized by IF.
View Differences

End of Search Ads API v15

Search Ads API v15 will end with the following schedule:

• Support end date: July 28, 2025
• End of life date: Early of November 2025 (scheduled)
  *Wait for further announcements with detailed schedules.

Search Ads API v14 will end with the following schedule:

• End of life date: July 28, 2025
  *Support for this version has already ended.