LY Ads API | Developer Center

LY Ads Search Ads API v20 Release Note

Version released

v20

Date

July 8, 2026

Key points of this release

*Learn more about objects, etc. in the reference document.

Adding support for submitting Shopping Search Ads

A new web service was added to support ad submission for Search Ads (Shopping).
See the following for details.
Adding support for submitting Shopping Search Ads to the Search Ads API

Note the following:

• Test accounts will not be issued.
• The QPS is fixed at "5" and cannot be raised.

Refer to the following for details about Shopping Search Ads.
About Search Ads (Shopping)

Changes

• Added the following new services.
  
  • SsaCampaignService
  • SsaCampaignTargetService
  • SsaCampaignNegativeKeywordService
  • SsaAdGroupService
  • SsaAdGroupTargetService
  • SsaAdGroupNegativeKeywordService
  • SsaProductGroupService
• The following items have been added to SsaCampaignService and SsaAdGroupService.
  The items will be available around the same time as the launch of new bid strategy in Search Ads (Shopping) announced in the next section.
  Launch of a new bid strategy and required preparations
  
  • Added an enum to each field.
    • SsaCampaignService/biddingStrategyType
    • SsaAdGroupService/campaignBiddingStrategyType
    • MAXIMIZE_CONVERSION_VALUE
    • MAXIMIZE_CLICKS
  • Added a field in biddingScheme to set the target ROAS value.
    • maximizeConversionValueBiddingScheme/targetRoas

Launch of new bid strategy for Search Ads (Shopping)

SsaReportDefinitionService has been updated to support the addition of new bid strategies for autobidding in Search Ads (Shopping).
See the following information for details on when the feature will become available.
Launch of a new bid strategy and required preparations

Services

• SsaReportDefinitionService

Changes

• Added an Enum to the bid strategy that can be applied in SsaReportDefinitionService.
  • TARGET_ROAS
  • MAXIMIZE_CONVERSION_VALUE
  • MAXIMIZE_CLICKS

Improved display of review and delivery status for Responsive Ads for Search

New fields were added to the CampaignExportService to support improvements to the display of review status and other information for Responsive Ads for Search.
See the following information for details on when the feature will become available.
Improved display of review and delivery status for Responsive Ads for Search

Services

• CampaignExportService

Changes

• Added the following Enum to AdGroupAdApprovalStatuses in CampaignExportService.
  • APPROVED_WITH_PRE_DISAPPROVED
  • POST_DISAPPROVED_WITH_REVIEW

Adding asset metrics for Responsive Ads for Search and discontinuation of performance ratings

Support has been added for the discontinuation of asset-level performance ratings in Responsive Ads for Search. As a result, an error will occur if performance ratings is specified when creating a report.

Services

• ReportDefinitionService

Changes

The following error will return when specifying "performance ratings" in a report.

Error code: V0001
Error message: Invalid value.

AI keyword expansion

AI keyword expansion is now available.
See the following information for details on when the feature will become available.
Launch of AI keyword expansion

Services

• CampaignService
• AdGroupService

Changes

• Added a field for "AI keyword expansion" to CampaignService and AdGroupService.
  
  • CampaignService/get, add, set, remove: enableAiSetting
  • AdGroupService/get, add, set, remove: disableAiKeywordExpansion

Automation of ad display assets

Automation of ad display assets is now available.
See the following information for details on when the feature will become available.
Automation of ad display assets

Services

• AssetService
• AdGroupAssetService

Changes

• Added a field to AssetService/get, AdGroupAssetService/get to specify the source of the following assets:
  
  • Asset/createdBy
  • AssetServiceSelector/createdBy
  • AdGroupAsset/createdBy
  • AdGroupAssetServiceSelector/createdBy
• Changed AdGroupAssetService/set and replace as follows.
  • Added an error returned when associating a newly auto-generated asset, campaign, or ad group.
  • Added an error returned when changing the delivery setting of an association or removing an association while the delivery setting of the account, campaign, or ad group is turned off.

Maintenance

• Removed the following EntityTypes that are not available in the AuditLogService filter.
• FEED (Feed)
• FEED_ITEM (FeedItem)
• CAMPAIGN_FEED (CampaignFeed)
• AD_GROUP_FEED (AdGroupFeed)
• AD_CUSTOMIZER (AdCustomizer)
• EXCLUDE_AD_CUSTOMIZER (ExcludeAdCustomizer)
• PAGE_FEED_ASSET (PageFeedAsset)

• In the Java client libraries for v17-v19, the class name YahooJapanAdsApiClient has been changed to AdsApiClient.

Differences between v19 and v20 IF

You can view the differences between Search Ads API v19 and v20 on this page, organized by IF.

Upgrading client library for Java users

The client library of the LY Ads API released for Java users is now compatible with Spring Framework 7 series. We have also updated the version corresponding to the previous version (Spring Framework 6 series).
Select the client library that supports Spring Framework 6 or 7 series according to your system requirements.
Each release of the library and the system requirements are as follows.

*To maintain the previous system environment, use the Spring Framework 6-compatible version. Please note that support for the Spring Framework 6-compatible version will end after a certain period. We recommend migrating to the Spring Framework 7-compatible version as soon as possible.

We have changed the following property in the retry settings when updating the access token.
Before: jp.co.yahoo.adssearchapi.oauth2.retry.max_attempts
After: jp.co.yahoo.adssearchapi.oauth2.retry.max_retries
In addition, the retry count has been changed from "Maximum attempts" to "Maximum retries." To maintain the same number of attempts as before, set the value to one less than the existing setting.

End of LY Ads API v18

LY Ads API v18 will end with the following schedule.
*These dates are subject to change.

• Support end date: August 5, 2026
• End of life date: Early December 2026

LY Ads API v17 will end with the following schedule.

• End of life date: August 5, 2026
  *Support for this version has already ended.