Share your feedback about the Google Ads (AdWords) API. Take the 2021 AdWords API and Google Ads API Annual Survey.
The AdWords API will sunset on April 27, 2022. Migrate to the Google Ads API to take advantage of the latest Google Ads features.

Migration Guide (v201809)

This page covers incremental changes introduced in v201809 that may remove or change functionality provided in previous versions. If you're moving multiple versions at once, make sure to consult each migration guide in sequence for a complete picture of API changes.

Changes to services and their components
AdGroupCriterionService Placement

Positive Placement criteria will no longer be allowed within Search campaigns. Use other targeting types instead.

AdGroupCriterionService Placement

Excluding a Placement target with a URL equal to adsenseformobileapps.com will now fail with the error reason ADSENSE_FOR_MOBILE_APPS_PLACEMENT_DEPRECATED. Previously, such requests failed with error reason INVALID_PLACEMENT_URL.

AdGroupCriterionService BiddableAdGroupCriterion

The destinationUrl field has been removed. It was previously deprecated when we added support for finalUrl fields.

CampaignCriterionService
CampaignNegativeCriterionService 		ContentLabelType

The following content label types have been removed:

  • AFE
  • CONFLICT
  • UGC_FORUMS
  • UGC_IMAGES
  • UGC_SOCIAL
  • UGC_VIDEOS
  • SIRENS
  • ALLOWED_GAMBLING_CONTENT

    • AdGroupAdService
    AdService     		CallOnlyAd

    The new error reason CUSTOMER_CONSENT_FOR_CALL_RECORDING_REQUIRED can be returned if the customer hadn't consented for call recording, which is required for adding or updating a CallOnlyAd.

    CampaignService Campaign

    The new error reason CAMPAIGN_CANNOT_USE_SHARED_BUDGET_WHILE_PART_OF_CAMPAIGN_GROUP was added and will be returned under relevant circumstances.

    Reporting Destination URL Report

    DESTINATION_URL_REPORT was removed when Upgraded URLs support was added to the API. Use FINAL_URL_REPORT instead.