Przykładowy przypadek użycia

Ten przypadek użycia podsumowuje skuteczność konta w ciągu ostatnich 30 dni według kampanii, z podziałem na urządzenia. Zapytanie do tego raportu wygląda tak:

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

Aby wysłać to żądanie, przekaż tę instrukcję w języku zapytań Google Ads do GoogleAdsService.SearchStream interfejsu.

Adres URL żądania HTTP

Żądanie składa się z żądania HTTP POST do serwera interfejsu Google Ads API pod tym adresem URL:

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

Zastąp {customer_id} identyfikatorem konkretnego konta Google Ads, o które chcesz wysłać zapytanie. Nie umieszczaj w identyfikatorze myślników. Jeśli chcesz pobrać dane subkonta, musisz użyć jego identyfikatora. Wysyłanie zapytań za pomocą identyfikatora konta menedżera zwraca tylko dane, które są bezpośrednio powiązane z tym kontem menedżera, i nie obejmuje danych z jego subkont.

Pełny przykład żądania HTTP

Oto pełny przykład definicji tego raportu, ujęty w żądanie 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"
}

Przykładowe fragmenty kodu

Obejrzyj film z omówieniem przykładowego kodu, który wyszukuje kampanie z danymi z ostatnich 7 dni. Ten przykładowy kod jest napisany w języku Java, ale proces jest podobny we wszystkich językach.