Recursos automáticos

A API Google Ads é compatível com recursos automáticos gerenciados diretamente pelo Google Ads, com o escopo da API limitado a pausar ou remover recursos individuais e recuperar estatísticas. Você pode ativar ou desativar os recursos automáticos na interface da Web do Google Ads.

Criação e atualização

Quando uma conta é ativada para esse recurso, o Google Ads cria recursos automáticos da seguinte maneira:

  1. Os recursos são criados.
  2. Os objetos CampaignAsset, AdGroupAsset ou CustomerAsset são criados para associar o recurso à campanha, ao grupo de anúncios ou aos recursos do cliente, respectivamente.

Não é possível criar ou atualizar recursos automáticos usando a API Google Ads, nem criar CampaignAsset, AdGroupAsset ou CustomerAsset para os recursos automáticos usando a API Google Ads.

É possível pausar ou remover entidades CampaignAsset, AdGroupAsset ou CustomerAsset que associam o recurso automatizado ao recurso correspondente.

Pausar ou remover a associação

Pausar a associação desativa temporariamente a veiculação do recurso na entidade correspondente. Depois que você pausar a associação, o Google Ads não reativará nem exibirá automaticamente o recurso correspondente nesse recurso até que ele seja reativado por meio da interface da Web ou da API. Remova a associação para desativar permanentemente a associação entre o recurso e o recurso.

O Google Ads impõe um limite quanto ao número de recursos automáticos de determinado tipo que podem ser associados a uma determinada entidade (por exemplo, o número de sitelinks automáticos por campanha). Uma associação pausada é contabilizada nesse limite, enquanto uma associação removida não. Os recursos automáticos não são contabilizados nos limites de recursos adicionados manualmente.

Recuperar recursos automáticos

É possível recuperar dados de recursos automáticos filtrando por AssetSource = AUTOMATICALLY_CREATED. Para recursos que podem ser vinculados a anúncios, consulte source. Consulte AssetType para conferir uma lista de tipos de recursos que podem ser vinculados a anúncios.

Este é um exemplo de consulta para recursos em um anúncio:

SELECT
  ad_group.name,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.ad_group_ad
FROM ad_group_ad_asset_view
WHERE asset.source = 'AUTOMATICALLY_CREATED'

Para outros tipos de recursos, consulte o recurso Asset diretamente:

SELECT
  asset.id,
  asset.name
FROM asset
WHERE asset.source = 'AUTOMATICALLY_CREATED'

Relatórios

As estatísticas de performance dos recursos podem ser solicitadas no relatório asset_field_type_view. Esse relatório inclui as estatísticas agregadas dos recursos automáticos e adicionados manualmente.

As estatísticas de performance de recursos individuais podem ser recuperadas nos relatórios campaign_asset, customer_asset e ad_group_asset.

Se você ativou o recurso de recursos automáticos na sua conta, o histórico de estatísticas deles também vai estar disponível no relatório feed_placeholder_view.