Google Ads Developer Blog: labels

Announcing v201502 of the AdWords API

Thursday, March 5, 2015

As with every new version of the AdWords API, we encourage you to carefully review all changes in the release notes and the v201502 migration guide. The updated client libraries and code examples will be published shortly. With this release, we've also updated the Required Minimum Functionality document to include some of the newly added features. If you have any questions or need help with migration, please post on the forum or the Ads Developers Plus Page.

- Danial Klimkin, on behalf of AdWords API Team.

Today we're announcing the release of AdWords API v201502. Here are the highlights:

Ad extension services. We heard your feedback about Feed Services being overly complex for many cases. To help simplify ad extension management, we've added new ExtensionSetting services. Existing Feed Services are still supported so you can continue using them. Should you decide to migrate to the new services, we've prepared a migration guide.
Account labels. We've expanded support for labels to MCC manager accounts. Now you can tag your accounts with text labels programmatically.
In-place URL upgrade for ads. The AdGroupAdService now supports upgradeUrl method which simplifies the Upgraded URLs migration.
Updates to reporting. Two new reports have been added: UserAdDistance performance and Label. Reporting now supports skipColumnHeader HTTP header which removes column headers from the produced report. We've also added several new columns across reports, see the release notes for the full list.
Shared sets. These are now available to all AdWords API users. Check out this feature if you often need to attach large sets of negative keywords or placements to many campaigns.
Support for application deep links. You can now create ads linking to specific activities in your application using AppUrlList.
Additional controls on Local Inventory Ads. You can now enable local inventory as well as set product channel / channel exclusivity.
Cross-account as well as system-defined conversion trackers are now easy to identify. Look at the conversionTypeOwnerCustomerId in ConversionTracker. Accounts using cross-account conversion tracking can be identified using the effectiveConversionTrackingId.
Account-level remarketing tags can now be retrieved using CustomerService RemarketingSettings.
The new TargetOutrankShare bidding strategy is now supported.

If you're still using v201406 of the AdWords API, please note that it's being sunset on April 6th, 2015. We encourage you to skip v201409 and migrate straight to v201502. If you're using v201409, be aware it's now marked deprecated and will be sunset on July 14th, 2015.

- Danial Klimkin, on behalf of AdWords API Team.

New labels features in AdWords API v201406

Thursday, July 10, 2014

Many developers in the AdWords API community have mentioned that being able to create, modify, assign, and report on labels through the API would be extremely helpful. Well, we're excited to report that the v201406 release of the AdWords API includes all of these requested features!

Summary of label services and features

New LabelService for creating, modifying, and retrieving labels.
A new mutateLabels method in CampaignService, AdGroupService, AdGroupAdService, and AdGroupCriterionService for assigning and removing labels on your campaigns, ad groups, ads, and keywords.
New Predicate operators that allow you to select objects by one or more label IDs.
A new Labels field in multiple reports so you can retrieve labels for your objects and filter your report results by one or more label IDs.

End-to-end example
So how do these new features work together? Check out our labels guide to get you on the road to AdWords label expertise!

Next steps
If you've never used labels in your account or need a refresher course, check out the Help Center labels guide. Once you're ready to dive in, try out the label examples in your client library of choice.

Still have questions? Feel free to visit us on the AdWords API Forum or our Google+ page.

- Josh Radcliff, AdWords API Team

Ads Developer Blog

Announcing v201502 of the AdWords API

New labels features in AdWords API v201406

Labels

Archive