A API Search Ads 360 Reporting é baseada em uma plataforma moderna e apresenta vários conceitos novos. Eles são descritos nas seções a seguir.
Recursos
Os objetos de recurso substituem os tipos de relatório. Em vez de solicitar tipos de relatório predefinidos, agora você pode consultar todos os recursos usando uma nova linguagem de consulta semelhante a SQL. Consulte a estrutura da API Search Ads 360 Reporting para saber mais.
Relatórios de pesquisa
A Pesquisa tem o próprio serviço na nova API. O serviço de pesquisa substitui o serviço de relatórios legado. Todas as consultas passam por
SearchAds360Service, que fornece dois métodos, SearchStream e Search,
para pesquisar e recuperar dados e métricas de relatórios. Os dois métodos de pesquisa retornam todos os objetos SearchAds360Row que correspondem à sua consulta de pesquisa. Consulte Criar relatórios de pesquisa para mais informações.
Metadados do recurso
SearchAds360FieldService permite solicitar dinamicamente o catálogo de recursos, campos de recursos, chaves de segmentação e métricas disponíveis nos métodos de pesquisa SearchAds360Service. Consulte
Recuperar metadados de recursos
para saber mais.
Nomes de campos
A API introduz nomes de campos aninhados, separados com a notação de ponto. Por
exemplo, campaign.id e ad_group.id. Você também pode aninhar ainda mais, por
exemplo,ad_group.campaign.id. Consulte a estrutura da API Search Ads 360 Reporting para saber mais.
Os relatórios da API Search Ads 360 anterior são baseados em campos separados de entidades diferentes para conceitos semelhantes. Por exemplo, os relatórios campaign e adgroup incluem um campo campaignId
separado.
Linguagem da consulta
A API apresenta a linguagem de consulta do Search Ads 360. É uma linguagem flexível semelhante a SQL que permite definir consultas para recuperar os dados de relatório específicos mais adequados ao seu negócio. Consulte Linguagem de consulta do Search Ads 360 para saber mais.
Receber solicitações
Na nova API, a pesquisa tem o próprio serviço (SearchAds360Service), mas as solicitações GET ainda existem no serviço específico de cada entidade. Por exemplo, é possível ver informações de colunas personalizadas do CustomColumnService. Consulte Alterações de formato na API Search Ads 360 Reporting para saber mais.
Colunas personalizadas
No novo Search Ads 360, as colunas de fórmula e as conversões personalizadas são chamadas de colunas personalizadas. Saiba mais sobre as colunas personalizadas. O novo CustomColumnService ativa colunas personalizadas. Se você tiver as permissões necessárias, poderá solicitar recursos CustomColumn de qualquer conta na
árvore de contas.
Gerenciamento da conta
O novo Search Ads 360 organiza as contas em uma hierarquia de contas de administrador, subadministrador e cliente. Uma conta de administrador representa a conta da agência, e as contas de subadministrador representam as contas de anunciantes no antigo Search Ads 360. Consulte Sobre as contas de administrador do Search Ads 360 para saber mais.
Consulte a árvore de contas e envie solicitações para cada conta da qual você quer gerar relatórios de dados.
Como resultado da mudança na hierarquia da conta, os campos relacionados ao conceito de anunciante/agência foram substituídos por alternativas apropriadas para oferecer paridade funcional sempre que possível. Para ver uma lista dos campos afetados e os substitutos, consulte Mapeamentos de campos.
Cabeçalho do ID de cliente de login
login-customer-id é um novo cabeçalho necessário ao usar uma conta de administrador para acessar uma conta de subadministrador ou de cliente. Consulte o cabeçalho do ID de cliente de login para mais informações.
Controle de versões
A API Search Ads 360 Reporting usa o controle de versões semântico.
Há versões principais e secundárias, formatadas como
vMAJOR_MINOR. Consulte Controle de versões para saber mais.