Ejemplo de caso de uso común

Ahora analizaremos un caso de uso común: resumir el rendimiento de una cuenta en los últimos 30 días por campaña, segmentada por dispositivo. La consulta para este informe es la siguiente:

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 esta solicitud, pasa la declaración del lenguaje de consulta de Google Ads anterior a la interfaz de GoogleAdsService.SearchStream.

Punto clave: En este ejemplo, se muestra la solicitud HTTP subyacente solo como un método de enseñanza. Te recomendamos que uses una de las bibliotecas cliente para enviar solicitudes en tu propia app.

URL de solicitud HTTP

La solicitud consiste en una solicitud HTTP POST al servidor de la API de Google Ads en la siguiente URL:

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

Muestra de solicitud HTTP completa

A continuación, se muestra un ejemplo completo de la definición de informe anterior, incluida en una solicitud HTTP POST.

POST /v16/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"
}

Muestras de código

Mira un video explicativo de una muestra de código que busca campañas con métricas durante los últimos 7 días. La muestra de código del video está escrita en Java, pero el proceso es similar para todos los lenguajes.