Developer Center (English) > Startup Guide > Versioning Change

ここから本文です
        

Versioning Change

In Yahoo! JAPAN Promotional Ads API, the version will be upgraded 3 or 4 times a year in order to add new functions or to fix bugs.
The period of versioning up may be changed every year.
 
After we release new version, we will state support ending date of old version.
 
If version up is held, the previous version will be supported for a certain period.
Continue using the same service will not be possible if not correspond to new application by the end date.
 
We recommend that you upgrade the latest version as soon as possible after release of the new version.
 
Please confirm from Announcement regarding the release of the new version.
 
 

Types of version up

Required actions when upgrading is as below.
Please confirm from Release Notes in GitHub regarding the technical content of the new version.
 
Sponsored Search API V201805 and YDN API V201806 or later

Types of Version Up Required Actions
(Example)
Vyyyymm -> VYYYYMM
Need to adapt your application to new version before previous version support is terminated. Termination date shall be announced separately.
If your application cannot comply with the new version, you may fail to use the service.
A new version will require new URLs, WSDLs, end-points, and a new namespace.
 
(Example 1) Sponsored Search API V201805
The following examples show how the URLs for the LocationService change during a new version release.
 
<<Production>>
V201805
https://ss.yahooapis.jp/services/V201805/LocationService?wsdl

V201905
https://ss.yahooapis.jp/services/V201905/LocationService?wsdl
 
<<Sandbox>>
V201805
https://sandbox.ss.yahooapis.jp/services/V201805/LocationService?wsdl

V201905
https://sandbox.ss.yahooapis.jp/services/V201905/LocationService?wsdl
 
(Example 2) YDN API V201806
<<Production>>
V201806
https://im.yahooapis.jp/services/V201806/LocationService?wsdl

V201906
https://im.yahooapis.jp/services/V201906/LocationService?wsdl
 
<<Sandbox>>
V201806
https://sandbox.im.yahooapis.jp/services/V201806/LocationService?wsdl

V201906
https://sandbox.im.yahooapis.jp/services/V201906/LocationService?wsdl

 
Before Sponsored Search API version 6.5 and YDN API version 6.1

Types of Version Up Required Actions
Major version up
(Example)
version 1.0.0 -> 2.0.0
Need to adapt your application to new version before previous version support is terminated. Termination date shall be announced separately.
If your application cannot comply with the new version, you may fail to use the service.
A major version will require new URLs, WSDLs, end-points, and a new namespace.
 
(Example 1) Before Sponsored Search API version 6.5
The following examples show how the URLs for the LocationService change during a major version release.
 
<<Production>>
version 1.x.x
https://ss.yahooapis.jp/services/V1/LocationService?wsdl

version 2.x.x
https://ss.yahooapis.jp/services/V2/LocationService?wsdl
 
<<Sandbox>>
version 1.x.x
https://sandbox.ss.yahooapis.jp/services/V1/LocationService?wsdl

version 2.x.x
https://sandbox.ss.yahooapis.jp/services/V2/LocationService?wsdl
 
(Example 2) Before YDN API version 6.1
The following examples show how the URLs for the LocationService change during a major version release.
 
<<Production>>
version 1.x.x
https://im.yahooapis.jp/services/V1/LocationService?wsdl

version 2.x.x
https://im.yahooapis.jp/services/V2/LocationService?wsdl
 
<<Sandbox>>
version 1.x.x
https://sandbox.im.yahooapis.jp/services/V1/LocationService?wsdl

version 2.x.x
https://sandbox.im.yahooapis.jp/services/V2/LocationService?wsdl
Minor version up
(Example)
version 1.0.0 -> 1.1.0
Subordinate version is adaptable.
However, new functions may not be supported.
If you like to use the new functions, please adapt your application to the new version.
Patch
(Example)
version 1.0.0 -> 1.0.1
No action is required.

 
 

Release Information for New Version

We will inform the version update information, including the sandbox, to your registered contact person. The version update information can be confirmed on Developer Center.
If new version is going to release the sandbox first, reference of the new version will be available in Download page from Developer Center. After the production release, the reference will be available in GitHub.
 
 

Schedule of release and sunset

The release date, sunset date and end of life date for each version, please refer from GitHub.

        
Text ends here Top of page