Пример общего случая использования

В этом примере использования представлена ​​сводная информация о производительности аккаунта за последние 30 дней по кампаниям, с разбивкой по устройствам. Запрос для этого отчета выглядит следующим образом:

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

Для отправки этого запроса передайте следующее выражение языка запросов Google Ads в интерфейс GoogleAdsService.SearchStream .

URL HTTP-запроса

Запрос представляет собой HTTP POST-запрос к серверу Google Ads API по следующему URL-адресу:

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

Замените {customer_id} на идентификатор конкретного аккаунта Google Ads, для которого вы хотите выполнить запрос. Не используйте дефисы в идентификаторе. Если вы хотите получить данные для дочернего аккаунта, необходимо использовать идентификатор этого дочернего аккаунта. Запрос с использованием идентификатора управляющего аккаунта возвращает только данные, непосредственно принадлежащие этому управляющему аккаунту, и не включает данные из его дочерних аккаунтов.

Полный пример HTTP-запроса

Вот полный пример определения этого отчета, заключенный в HTTP POST-запрос.

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

Примеры кода

Посмотрите видео с демонстрацией примера кода, который выполняет поиск кампаний по метрикам за последние 7 дней. Этот пример кода написан на Java, но процесс аналогичен для всех языков программирования.