Exemplo de caso de uso comum

Agora vamos analisar um caso de uso comum: resumir a performance de uma conta nos últimos 30 dias por campanha, segmentada por dispositivo. A consulta para este relatório é a seguinte:

SELECT
  campaign.name,
  campaign.status,
  segments.device,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

Para emitir essa solicitação, transmita a declaração da linguagem de consulta do Google Ads acima à interface do GoogleAdsService.SearchStream.

Importante: este exemplo mostra a solicitação HTTP subjacente apenas como um método de ensino. Recomendamos o uso de uma das bibliotecas de cliente para enviar solicitações no seu próprio app.

URL de solicitação de HTTP

A solicitação consiste em um POST HTTP para o servidor da API Google Ads no seguinte URL:

https://googleads.googleapis.com/v19/customers/{customer_id}/googleAds:searchStream

Exemplo de solicitação HTTP completa

Confira um exemplo completo da definição de relatório acima, incluído em uma solicitação HTTP POST.

POST /v19/customers/{customer_id}/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]
developer-token: [Enter developerToken here]

Parameters:
{
  "query" : "SELECT campaign.name, campaign.status, segments.device,
                    metrics.impressions, metrics.clicks, metrics.ctr,
                    metrics.average_cpc, metrics.cost_micros
            FROM campaign
            WHERE segments.date DURING LAST_30_DAYS"
}

Amostras de código

Assista um tutorial em vídeo de um exemplo de código que pesquisa campanhas com métricas nos últimos sete dias. O exemplo de código no vídeo está escrito em Java, mas o processo é semelhante em todos os idiomas.