In addition to manual extensions, the Google Ads API supports automated asset-based extensions, also known as dynamic extensions. As the name implies, automated extensions are managed automatically by Google Ads, and the scope of the API is limited to pausing or removing individual extensions and retrieving stats.
Extension creation and updates
Once an account is opted in to this feature, Google Ads creates automated extensions as follows:
- Assets are created for the automated extension.
CustomerAssetobjects are created to associate the extension with campaign, ad group, or customer resources, respectively.
Pause or remove the association
Pausing the association disables the extension from serving against the corresponding entity temporarily. Once you pause the association, Google Ads won't automatically re-enable or serve the corresponding automated extension against that resource until it is re-enabled through the UI or API. Remove the association to permanently disable the extension from being associated with the entity.
Google Ads enforces a limit on the number of automated extensions of a given type that can be associated with a given entity (for example, automated sitelinks per campaign). A paused association counts against this limit, whereas a removed association doesn't. Automated extensions don't count towards the limits for manually added extensions.
Retrieving automated extensions
API version v11 and higher lets users retrieve automated extensions. You can
AssetSource = AUTOMATICALLY_CREATED
entities. The following automated extension types are currently supported:
- Structured snippet
More extension types could be supported in the future.
Asset-based extension performance statistics can be requested from the
asset_field_type_view report. This report
includes the aggregated stats for both automated and manual extensions.