Yahoo! JAPAN Ads API v4 release

Document Number: APIE-FY20-2157


Dear customer,

Thank you for using Yahoo! JAPAN Ads.

We will release a new version for Yahoo! JAPAN Ads API. Please see
the following details.

Once again, thank you for using Yahoo! JAPAN Ads.


1. Product:
 Yahoo! JAPAN Ads Search Ads API
 Yahoo! JAPAN Ads Display Ads API

2. Version released:
 v4

3. Schedule:
 February 24, 2021 (Wed)
 *Schedule may change without prior notice.

4. Changes on Search Ads API:
 ■MCC accounts
 Search, browse, edit MCC account will become available
 *This feature is already available on the Campaign Management Tool.
 See the following release note for more detail.
 [Yahoo! JAPAN Ads] MCC account will become available
 
 Along with this enhancement, the following changes will be made.
 ・Add AccountLinkService as new and support "/get" for getting
 managerAccountId
 ・Remove "managerAccountId" of AccountService

 ■Changes on reporting
 Change item names of filtering conditions on ReportDefinitionService
  before => after
  reportOperator => filterOperator
  value => values

 ■Changes on proposal service
 We will make the following changes on the proposal service.
 ・Add KeywordPlanIdeaService as new
 ・Remove TargetingIdeaService
  *Similar function will become available on KeywordPlanIdeaService
 ・Change QPS of proposal service to "maximum 1 case/sec"

 ■Maintenance release
 ・Supports reverse lookup of keywords.
  By specifying the keyword (term), keyword match type, and ad group ID
  at the time of AdGroupCriterionService/get, get keyword ID will
  become available.

 ・Change some values of Enum that describes the character code of
  download files to unify notation.
  Following services will have the change.
   ReportDefinitionService
   AuditLogService
   CampaignExportService
   PageFeedItemService

 ・Change the request interface on "addDownloadJob" of PageFeedItemService

5. Changes on Display Ads API:
 ■MCC accounts
 Search, browse, edit MCC account will become available.
 *This feature is already available on the Campaign Management Tool.
 See the following release note for more detail.
 [Yahoo! JAPAN Ads] MCC account will become available
 
 Along with this enhancement, the following changes will be made.
 ・Add AccountLinkService as new and support "/get" for getting
 managerAccountId
 ・Remove "managerAccountId" of AccountService

 ■Get Video view through rate
 Get "Video view through rate" will become available on StatsService.
 *This feature is already available on the Campaign Management Tool.
 See the following release note for more detail.
 [Display Ads] Added a new metrics "Video view through rate"
 
 ■Changes on reporting
 Following changes will be made on ReportDefinitionService.
 ・Becomes available to specify the presence or absence of "header line"
  and "total line" of the reports
 ・The display type of numbers including decimal point becomes selectable
  from "display all" and "simple display".
 ・Change some values of Enum that describes the character code of
  download files to unify notation.

 ■Maintenance release
 There are changes to the following services in order to add functions
 in the future. We will make another announcement once the detail has
 been decided.
  PlacementUrlListService
  ReportDefinitionService
  SearchKeywordIdeaService
  StatsService

6. Remarks:
 ・More details will be available on the release note and reference
  document provided on the new version release.
  
 ・We will hold an online seminar to give an overview of v4 along with
  the release. We will make another announcement once details have
  been decided.

7. Yahoo! JAPAN Ads API v2 Sunset:
 Yahoo! JAPAN Ads API v2 sunset is scheduled as follows.
  Deprecation Date : March 22, 2021 (Mon)
  End of Life Date : July 20, 2021 (Tue)

 Yahoo! JAPAN Ads API v1 will also end on the following scheduled date
 as previously announced in "Yahoo! JAPAN Ads API v3 released (Document
 Number: APIE-FY20-2101)." 
  End of Life Date : March 22, 2021 (Mon)
  *We have ended the user support for this version already.


If you have any questions, please contact us.

Sincerely,
Yahoo! JAPAN API support team