Recursos automáticos

A API Google Ads é compatível com recursos automáticos gerenciados diretamente pelo Google Ads, com o limite da API restrito à pausa ou remoção de recursos individuais e à recuperação de estatísticas. Você ativa ou desativa os recursos automáticos na interface da Web do Google Ads.

Criação e atualização

Depois que uma conta ativa esse recurso, o Google Ads cria recursos automáticos da seguinte forma:

  1. Os recursos são criados.
  2. CampaignAsset, AdGroupAsset ou CustomerAsset são criados para associar o recurso aos recursos de campanha, grupo de anúncios ou 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 automático 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 ou veicular automaticamente o recurso correspondente até que ele seja reativado pela interface da Web ou pela API. Para desativar permanentemente a associação entre recurso e recurso, remova a associação.

O Google Ads limita o número de recursos automáticos de um determinado tipo que podem ser associados a uma entidade, por exemplo, o número de sitelinks automáticos por campanha. Uma associação pausada é contabilizada nesse limite, mas uma removida não. Os recursos automáticos não são contabilizados nos limites para recursos de anúncio adicionados manualmente.

Recuperar recursos automáticos

Para recuperar dados de recursos automáticos, filtre por AssetSource = AUTOMATICALLY_CREATED. Para recursos que podem ser vinculados a anúncios, verifique o source do recurso. Consulte AssetType para ver uma lista de tipos de recursos que podem ser vinculados a anúncios.

Veja 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,
  ad_group_ad_asset_view.source
FROM ad_group_ad_asset_view
WHERE ad_group_ad_asset_view.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 de recursos podem ser solicitadas no relatório asset_field_type_view. Esse relatório inclui as estatísticas agregadas dos recursos de anúncio 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.