UpgradeService provides operations to preview the upgrade of your accounts to the new Sponsored Search.
Your Technical Account Management Team will oversee and manage the transition of your old accounts to the new Sponsored Search. Before an account is actually upgraded, it is placed in preview mode.
While the account is in preview mode, you may use the read-only ("get") operations from the Marketing API services to review the campaigns, ad groups, ads, and keywords that were derived from your current listings.
After you review the new account structure, you can activate the upgrade via your old account. Once the account is upgraded, you may use any of the Marketing API service operations to manage the account as well as the campaigns, ad groups, ads, and keywords within that account.
Note: After your accounts are upgraded, use the LocationService rather than the UpgradeService (see the LocationService Overview).
To review the accounts that are in preview mode, do the following:
Once you have formed the local URL and have the list of account IDs, you may use the read-only ("get") operations to preview and verify that your old accounts have been correctly transitioned to the new Sponsored Search (see Send a Request to a Service).
As noted, the UpgradeService has two operations, getMasterAccountLocationForUpgradePreview and getAccountsForUpgradePreview.
When you send a request to the UpgradeService using either of these operations, you do not use a local URL. Rather, you use the URL located in the UpgradeService WSDL file (sandbox, production).
Note: See the LocationService for more information.
To send a request to a service (other than the LocationService, UpgradeService, or VaultService) using the read-only "get" operations, do the following.
First, send a request to the UpgradeService (getMasterAccountLocationForUpgradePreview operation) to retrieve the URL prefix for colocation the preview mode accounts are assigned to. Next, combine the URL prefix with the current version (using variable V3) and service name to form the local URL (URL prefix / version / service). Then, reference the local URL when you post the request (see Requests and HTTPS).
For example, suppose you want to post a request to the CampaignService. If the URL prefix returned by the UpgradeService is
"https://pews411.marketing.ews.yahooapis.com/services"
then the local URL would be
"https://pews411.marketing.ews.yahooapis.com/services/V3/CampaignService".
Second, send a request to the UpgradeService (getAccountsForUpgradePreview operation) to retrieve a list of account IDs that are currently in preview mode. Then, include the account ID in the SOAP header of the request (see EWS Requests).