Migration Guide (v201809)

See Deprecation Schedule for deprecation and sunset dates.

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.

    Send feedback about...

    AdWords API
    AdWords API
    Need help? Visit our support page.