Yahoo! JAPAN Ads API | Developer Center

What's new on v12

About this page

1. Difference between v11 and v12

2. Notes when updating

(1) MCC account multiple-level structure

From v12, specifying x-z-base-account-id is required in the request header for all services.
*See the following page for more details.
MCC account settings will be available for multiple-level structure
The page 22 to 35 inWebinar documents

If you are generating a client using OpenAPI, it is necessary to handle the "x-z-base-account-id" parameter. As shown in the diagram below, it needs to be specified as a function argument.

(2) Specification changes to Responsive Display Ads reporting

This feature is already available in the Campaign Management Tool. In the Yahoo! JAPAN Ads API, this change has been adopted with v12.
The action categories of the title and description will be Segment items (split) in the next version.

*See the following page for more details.
Display Ads (Auction) Responsive Ads for Display reports available for title and description
The page 12 to 13 in Webinar documents

(3) Improve the download feature of change history

The item for change history has been unified for Search and Display.
Please note that if you are processing by specifying columns, be aware during version upgrades.
Also, please note that change history added in v11 or earlier cannot be retrieved using "get" in v12.

Changed the date format of dateRange.startDate and dateRange.endDate from "yyyyMMMddHHmmss" to "yyyyMMMdd".
Please note that there is no backward compatibility, so when upgrading versions, please remove the parts corresponding to hours, minutes, and seconds.

*See the following page for more details.
The page 18 to 21 in Webinar documents
AuditLog item of Display Ads
AuditLog item of Search Ads

(4) About the client library for Java users

From previous version(v11), Client libraries for Java users has supported Spring Framework 6 series.
We will provide a parallel version (with "-spring5" ) that maintains the same operating environment as before for a certain period of time.

*See the page 16 in Webinar documents for more details.

3. Webinar information

We held the v12 update Webinar on June 26, 2023 (JST).
Learn more
The next Webinar will take place in January 2024. We will share more details with you about a month before the Webinar.

４．Appendix