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. Para ativar ou desativar os recursos automáticos, use a 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 vai reativar nem veicular automaticamente o recurso correspondente nesse recurso até que ele seja reativado por meio da interface da Web ou da API. Para desativar a associação entre o recurso e o recurso permanentemente, remova a associação.

O Google Ads impõe um limite ao número de recursos automáticos de um 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 conta nesse limite, ao contrário de uma associação removida. Os recursos automáticos não contam para os limites de recursos adicionados manualmente.

Recuperar recursos automáticos

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

Confira um exemplo de consulta de 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

Solicite as estatísticas de performance dos recursos 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ê tiver ativado o recurso de recursos automáticos na sua conta, as estatísticas históricas deles também poderão estar disponíveis no relatório feed_placeholder_view.