Search Ads API v9 Release Note

Release version

v9

Release date

September 13, 2022 (Tue)

Main Contents of this release

*More about objects and other details are described on the Reference document.

1. Ending Extended Text Ads Data Assignment

We will end adding new ads of Extended Text Ads. In addition, the Data Assignment List will no longer be available in Ad Customizer that can be used for Extended Text Ads and Dynamic Ads for Search. 
*The end of life date is scheduled for September 28, 2022 (Wed), not the release date of v9. See the following release note for more detail.


[Search Ads] End of Extended Text Ads and data assignment list, and add features on Responsive Ads for Search

Services

AdGroupAdService
FeedItemService
FeedService

Description

  • Ads with EXTENDED_TEXT_AD specified for adType in AdGroupAdService (add) can't be created.
    *Data from ads that have already been created can be retrieved.

  • FeedItemService (add, set, remove, setTrademarkStatus) can't be used; only get is available.
  • FeedService (add, set, remove, setTrademarkStatus) can't be used; only get is available.

2. Changing the names of items along with the renewal of the Campaign Management Tool

Along with the renewal of the Campaign Management Tool, we have changed the names of items related to campaigns and ad groups.

Services

CampaignService
BiddingStrategyService
AdGroupService
AdGroupCriterionService
AuditLogService
ReportDefinitionService
CampaignExportService

Description

Details of the name change for each service are as follows:

Service

Before

After

CampaignService
BiddingStrategyService

biddingStrategyName

portfolioBiddingName

biddingStrategyId, biddingStrategyIds

portfolioBiddingId, portfolioBiddingIds

AdGroupService

biddingStrategyId, biddingStrategyIds

portfolioBiddingId, portfolioBiddingIds

adGroupAdRotationMode.adRotationMode

frequentlyRunBetterPerformingAdsMode

adGroupAdRotationMode.adRotationMode.OPTIMIZE

frequentlyRunBetterPerformingAdsMode.APPLY

adGroupAdRotationMode.adRotationMode.ROTATE_FOREVER

frequentlyRunBetterPerformingAdsMode.DONT_APPLY

AdGroupCriterionService

biddingStrategyId, biddingStrategyIds

portfolioBiddingId, portfolioBiddingIds

AuditLogService

ReportDefinitionService

CampaignExportService

See the following document for more details.
https://s.yimg.jp/images/ads-promo_edit/support/pdf/2208search_ads_labels.pdf

3. Adding items that can be specified in CampaignExportService (all versions)

We have added some items to CampaignExportService (getExportFields).

Service

CampaignExportService

Description

We have added the following items.

  • campaignTrackId
  • adGroupTrackId
  • criterionTrackId

This change has been implemented in all versions.

4. Adding corporate number on the views of create and edit ad account

We have added corporate number on the views of create and edit ad account. See the following release note for more detail.

[Yahoo! JAPAN Ads] Adding "corporate number" on the views of create and edit ad account

Service

AccountManagementService (add)

Description

client.corporateNumber is added as an entry field for the corporate number.

5. Maintenance release

・We have removed items that return the previous format conversion tags and site retargeting tags.

The services and fields are as follows:
*This feature is already closed on the Campaign Management Tool.
- Removed the snippet field of ConversionTrackerService
- Removed the snippet field of RetargetingListService

・We have removed KeywordEstimatorService.

Since this is no longer available in all versions, use KeywordForecastMetricsService in the future.

Yahoo! JAPAN Ads API v7 Sunset

Yahoo! JAPAN Ads API v7 sunset is scheduled as follows.
End of life date: February 27, 2023 (Mon)
*We have ended the user support on September 13, 2022 (Tue).

Yahoo! JAPAN Ads API v6 has also ended on the following scheduled date as previously announced in "Yahoo! JAPAN Ads API v8 released (Document Number: APIE-FY22-2224)."
End of life date: September 13, 2022 (Tue)
*We have ended the user support for this version already.