Provisioning API v0 Release Notes

The Provisioning API allows to provision Acquisio accounts.

Contact: api@acquisio.com

Releases by year:

• 2020
• 2019
• 2018
• 2017

21 February 2020

• GET

  /adplatform-master-accounts/id/{id}/adplatform-accounts:: The new query parameter embed allows to retrieve the children accounts under each Ad Platform master account.

16 January 2020

• POST

  /labels/name/{name}: New endpoint to create a label.

28 October 2019

• A new field named isLoginValid allows to verify if an Ad Platform account is linked properly to the Ad Platform. See endpoints like

  GET

  /adplatform-accounts.

22 August 2019

• POST

  /labels/resource/{resource}: New endpoint to edit the labels of many accounts or campaigns in a single operation.

05 August 2019

• GET

  /labels/resource/{resource}: Support for campaign labels has been added.

02 July 2019

• GET

  /labels/resource/{resource}: New endpoint to retrieve a list of resources (only accounts) with their associated labels.

03 June 2019

• 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.

27 May 2019

• POST

  /labels: Support for campaign labels has been added.

10 September 2018

• GET

  /labels: New endpoint to retrieve a list of labels and values currently being used.

• POST

  /labels: New endpoint to edit multiple resources to add or update labels.

• PUT

  /labels/name/{name}: New endpoint to update the name of a label.

• DELETE

  /labels/name/{name}: New endpoint to delete label values.

8 August 2018

• 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.
• 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

• GET

  /adplatform-master-accounts/id/{id}/billing-accounts: Retrieve a list of the billing accounts in an AdPlatform master account (AdWords only).

08 May 2018

• GET

  /adplatform-master-accounts/id/{id}/adplatform-accounts: New endpoint to retrieve a list of Ad Platform accounts in an Ad Platform master account.
• 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

• 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

• The page element has been removed from the responses of the paginated

  GET

  endpoints. The X-TotalCount HTTP header can be used instead.

24 January 2018

• 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}.
• 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

• POST

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

27 November 2017

• GET

  /adplatform-master-accounts/id/{id}: New endpoint to retrieve a single Ad Platform master account.

• GET

  /adplatform-master-reseller-accounts: New endpoint to retrieve a list of Ad Platform master reseller accounts (Bing Ads only).

• GET

  /adplatform-master-reseller-accounts/id/{id}: New endpoint to retrieve a single Ad Platform master reseller account (Bing Ads only).

• DELETE

  /adplatform-master-reseller-accounts/id/{id}: New endpoint to relete an Ad Platform master reseller account (Bing Ads only).

• GET

  /adplatform-accounts/id/{id}/campaigns: The new includeUnimported query parameter allows to determine if campaigns that haven’t been imported to the Acquisio platform should be included.

12 October 2017

• GET

  /adplatform-accounts: Retrieve a list of Ad Platform accounts.

• GET

  /adplatform-accounts/id/{id}: Retrieve a single Ad Platform account.

• GET

  /jobs/id/{id}: New endpoint to retrieve a single job.

• GET

  /jobs: New endpoint to retrieve a list of jobs.

• GET

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

11 September 2017

• Initial public release of Provisioning API.