Provisioning API v0 Release Notes

The Provisioning API allows to provision Acquisio accounts.

Contact: api@acquisio.com

Releases by year:


02 July 2019

New endpoints

Labels


03 June 2019

Breaking changes

Most endpoints

  • References to BingAds has been replaced by Microsoft Advertising, due to the recent rebranding. The constant BingAds has been renamed to MicrosoftAdvertising. The rename affects the response field adPlatformType for ad platform accounts related objects as well as type when it comes to link or creation of ad platform accounts, for example, LinkBingAdsAdPlatformAccount becomes LinkMicrosoftAdvertisingAdPlatformAccount, CreateBingAdsAdPlatformAccount becomes CreateMicrosoftAdvertisingAdPlatformAccount and BingAdsAdPlatformMasterAccount becomes MicrosoftAdvertisingAdPlatformMasterAccount.

23 May 2019

Improved endpoints

Labels


10 September 2018

New endpoints

Labels


8 August 2018

Improved endpoints

Accounts

  • Labels are being introduced in this new version of Provisioning.
  • GET
    /accounts
    : When using the GET endpoint, the field labels will be filled with the labels, if any, related to the account. Filtering by labels was added.
  • POST
    /accounts
    : Possibility of adding labels when creating a new account.
  • PUT
    /accounts/id/{id}
    : Possibility of editing labels when updating an account.
  • PATCH
    /accounts/id/{id}
    : Possibility of editing labels when updating an account.

Breaking changes

Most endpoints

  • References to AdWords has been replaced by Google Ads, due to the recent rebranding. The constant AdWords has been renamed to GoogleAds. The rename affects the response field adPlatformType for ad platform accounts related objects as well as type when it comes to link or creation of ad platform accounts, for example, LinkAdWordsAdPlatformAccount becomes LinkGoogleAdsAdPlatformAccount, CreateAdWordsPlatformAccount becomes CreateGoogleAdsAdPlatformAccount and AdWordsAdPlatformManagedAccount becomes GoogleAdsAdPlatformManagedAccount.

29 May 2018

New endpoints

Ad Platform Master Accounts


08 May 2018

New endpoints

Ad Platform Master Accounts

Improved endpoints

Ad Platform Accounts

  • Calls to retrieve one or many Ad Platform accounts include in the response the accountId to identify under which account each Ad Platform Account belongs. See endpoints like
    GET
    /adplatform-accounts
    .
  • GET
    /adplatform-accounts
    : Retrieve a list of Ad Platform accounts now accept an accountId query parameter to retrieve the Ad Platform accounts associated to one or many accounts.
  • POST
    /adplatform-accounts
    : The billing informations can now be provided for the creation of an AdWords Ad Platform account. See the new field billingInfo.

26 February 2018

Improved endpoints

Jobs

  • The resource Job has been modified to have sub types based on one of the following operations: DeleteJob, ImportCampaignJob, CloneCampaignJob, UnlinkJob. See endpoints like
    GET
    /jobs
    .

01 February 2018

Breaking changes

Pagination

  • The page element has been removed from the responses of the paginated
    GET
    endpoints. The X-TotalCount HTTP header can be used instead.

Error responses

  • The body returned in an error response has been simplified.

24 January 2018

Improved endpoints

Ad Platform Master Accounts

  • AdPlatformMasterAccount has a new status field to indicate if the link between the Acquisio platform and the Ad Platform (ex: AdWords) is currently active. The field adPlatformId of AdWordsAdPlatformMasterAccount can now be null if the status of the AdPlatformMasterAccount is not Active. See endpoints like
    GET
    /adplatform-master-accounts/id/{id}
    .

Ad Platform Accounts

  • Support to retrieve Facebook Ad Platform accounts has been added. See the type and the adPlatformType fields of AdPlatformAccount in endpoints like
    GET
    /adplatform-accounts/id/{id}
    .

30 November 2017

Improved endpoints

Campaigns

  • POST
    /campaigns/import
    : Import campaigns now allows to create a new campaign group to which the campaigns will be associated.

27 November 2017

New endpoints

Ad Platform Master Accounts

Ad Platform Master Reseller Accounts

Improved endpoints

Campaigns


12 October 2017

New endpoints

Ad Platform Accounts

Jobs

The resource Job allows to retrieve information about the asynchronous jobs that have been started from the Provisioning API.

Improved endpoints

Accounts

  • GET
    /accounts
    : The query parameter id has been added to retrieve many accounts by their id.

11 September 2017

New endpoints

Accounts

Ad Platform Master Accounts

Ad Platform Accounts

Campaigns

Power Cloner