A API Google Ads tem um relatório de métricas e recuperação de atributos unificado mecanismo que permite criar consultas usando a consulta do Google Ads Idioma. Isso permite consultas complexas que podem retornar grandes quantidades de dados sobre contas individuais do Google Ads.
É possível criar consultas usando os métodos Search ou SearchStream.
Os dois métodos aceitam as mesmas consultas e retornam resultados equivalentes. A
O método Search retorna dados em páginas de tamanho fixo de 10.000 linhas, permitindo
para iterar um conjunto de resultados usando paginação. Isso pode ser vantajoso em casos de
largura de banda ou condições de rede não confiáveis, por exemplo, para segmentar uma grande
em respostas menores que podem ser buscadas novamente se uma conexão for
perdidos. O método SearchStream, por outro lado, transmite o resultado inteiro
em uma única resposta, o que pode ser mais eficiente para dados em massa
recuperação.
Tanto Search quanto SearchStream usam o mesmo URL base:
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}
Se houver mais de 10.000 linhas nos resultados,um nextPageToken será
retornada na resposta:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
Repita a mesma consulta com um pageToken adicionado com os valores do
solicitação anterior busca a próxima página de resultados:
POST /v17/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}
Usar o método SearchStream, que retorna todos os resultados em uma única transmissão
resposta, altere o método de serviço no URL para searchStream
(pageSize e pageToken não são exigidos por SearchStream):
POST /v17/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}