My favorites | English | Sign in

Try Google Chrome's developer tools New!

AdWords API v2009

v2009 Docs | v13 Docs

Release Notes

v200909

What's New

  • Asynchronous bulk job support: Use BulkMutateJobService to build, schedule, and retrieve jobs that can operate on thousands of campaign objects.
  • Location extension support: Use CampaignAdExtensionService to augment your text ads with information about your business's physical location. You can also override location extensions on a per-ad basis using AdExtensionOverrideService For more information about how ad extensions work, read the AdWords Help Center overview.
  • Keyword and placement ideas: Use TargetingIdeaService to generate new keyword and placement ideas for your campaign ads.
  • API usage retrieval: Use InfoService to get information about your API usage, such as the amount spent on an operation in the past month or the number of API units available.
  • Ad parameters: Use AdParamService to perform on-the-fly updates to parameterized snippets of ad text.

API Changes

  1. AdExtensionOverrideService (new)
  2. AdGroupAdService (3 new, 3 changed, 0 removed)
    1. + type Audio
    2. + type DeprecatedAd
    3. + type TemplateAd
    4. ≠ enum Ad.Type
      1. + value TEMPLATE_AD
    5. ≠ enum AdError.Reason
      1. + value CUSTOMER_NOT_ELIGIBLE_FOR_UPDATING_BEACON_URL
      2. + value DIMENSION_ALREADY_IN_UNION
      3. + value DIMENSION_MUST_BE_SET
      4. + value DIMENSION_NOT_IN_UNION
      5. + value DOMESTIC_PHONE_NUMBER_FORMAT
      6. + value EMERGENCY_PHONE_NUMBER
      7. + value INCONSISTENT_STATUS_IN_TEMPLATE_UNION
      8. + value INVALID_ATTRIBUTES_FOR_MOBILE_IMAGE
      9. + value INVALID_ATTRIBUTES_FOR_MOBILE_TEXT
      10. + value INVALID_INPUT
      11. + value INVALID_MARKUP_LANGUAGE
      12. + value INVALID_MOBILE_CARRIER
      13. + value INVALID_NUMBER_OF_ELEMENTS
      14. + value INVALID_PHONE_NUMBER_FORMAT
      15. + value INVALID_TEMPLATE_DATA
      16. + value INVALID_TEMPLATE_ELEMENT_FIELD_TYPE
      17. + value INVALID_TEMPLATE_ID
      18. + value MARKUP_LANGUAGES_PRESENT
      19. + value MISSING_ADDRESS_COMPONENT
      20. + value MISSING_ADVERTISEMENT_NAME
      21. + value MISSING_MARKUP_LANGUAGES
      22. + value MISSING_MOBILE_CARRIER
      23. + value MISSING_PHONE
      24. + value MISSING_REQUIRED_TEMPLATE_FIELDS
      25. + value MISSING_TEMPLATE_FIELD_VALUE
      26. + value MISSING_URL_AND_PHONE
      27. + value MUST_USE_TEMP_AD_UNION_ID_ON_ADD
      28. + value UNION_DIMENSIONS_CANNOT_CHANGE
      29. + value UNKNOWN_ADDRESS_COMPONENT
      30. + value UNKNOWN_FIELD_NAME
      31. + value UNKNOWN_UNIQUE_NAME
      32. + value USER_DOES_NOT_HAVE_ACCESS_TO_TEMPLATE
    6. ≠ enum AdGroupAdError.Reason
      1. + value CANNOT_CREATE_DEPRECATED_ADS
  3. AdGroupCriterionService (no changes)
  4. AdGroupService (no changes)
  5. AdParamService (new)
  6. BulkMutateJobService (new)
  7. CampaignAdExtensionService (new)
  8. CampaignCriterionService (no changes)
  9. CampaignService (0 new, 2 changed, 0 removed)
    1. ≠ enum BudgetError.Reason
      1. + value INVALID_BUDGET_SCHEDULE
    2. ≠ enum CampaignError.Reason
      1. + value CANNOT_ADD_CAMPAIGN_WITH_CONVERSION_OPTIMIZER_BIDDING_STRATEGY
  10. CampaignTargetService (0 new, 1 changed, 0 removed)
    1. ≠ enum CampaignError.Reason
      1. + value CANNOT_ADD_CAMPAIGN_WITH_CONVERSION_OPTIMIZER_BIDDING_STRATEGY
  11. GeoLocationService (new)
  12. InfoService (new)
  13. TargetingIdeaService (new)

v200906

  • Initial release of Adwords API v2009