Recursos automáticos

A API Google Ads oferece suporte a recursos automatizados gerenciados diretamente pelo Google Ads, com o escopo da API limitado à 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. Os objetos CampaignAsset, AdGroupAsset ou CustomerAsset são criados para associar o recurso a recursos de campanha, grupo de anúncios ou cliente, respectivamente.

Não é possível criar nem atualizar recursos automatizados usando a API Google Ads, nem criar CampaignAsset, AdGroupAsset ou CustomerAsset para os recursos automatizados 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

A pausa da associação desativa temporariamente a veiculação do recurso em relação à entidade correspondente. Depois que você pausar a associação, o Google Ads não vai reativar ou veicular automaticamente o recurso correspondente a esse recurso até que ele seja reativado pela interface da Web ou pela API. Para desativar permanentemente a associação entre o recurso e o recurso, 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 para esse limite, mas uma associação removida não. Os recursos automáticos não são contabilizados nos limites dos recursos adicionados manualmente.

Extrair 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, verifique o source. Consulte AssetType para ver uma lista de tipos de recursos que podem ser vinculados a anúncios.

Confira 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 de recursos podem ser solicitadas no relatório asset_field_type_view. Esse relatório inclui as estatísticas agregadas dos recursos adicionados de forma automática e manual.

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