Język zapytań Google Ads

Język zapytań Google Ads może wysyłać zapytania do interfejsu Google Ads API

Zasoby oraz powiązane z nimi atrybuty, segmenty i dane za pomocą

GoogleAdsService Wyszukiwarka lub Strumień wyszukiwania

Wyniki zapytania w usłudze GoogleAdsService to lista GoogleAdsRow instancji, z każdą liczbą instancji GoogleAdsRow reprezentujące zasób. Jeśli wymagane są jakieś atrybuty lub dane, wiersz również zawiera te pola. Jeśli zostaną zażądane jakieś segmenty, odpowiedź zawiera też dodatkowy wiersz dla każdej krotki zasobu segmentu.

Metadane dotyczące dostępnych pól i zasobów w

GoogleAdsFieldService

Ta usługa udostępnia katalog pól, które można wykonać w postaci zapytań, ze szczegółowymi informacjami na temat ich zgodności i typu.

Wynikiem zapytania GoogleAdsFieldService jest lista GoogleAdsField instancji, z każdą GoogleAdsField z informacjami o wymaganym polu.

Zapytanie o atrybuty zasobu

Poniżej znajduje się podstawowe zapytanie o atrybuty zasobu kampanii ilustrujące, jak aby zwracać identyfikator, nazwę i stan kampanii:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

To zapytanie porządkuje według identyfikatora kampanii. Każda wynikowa wartość GoogleAdsRow będzie reprezentować obiektu campaign wypełnionego wybranymi polami (w tym danym resource_name kampanii).

Aby dowiedzieć się, jakie inne pola są dostępne przy zapytaniach dotyczących kampanii, zapoznaj się z dokumentację Campaign.

Wysyłanie zapytań o wskaźniki

Oprócz wybranych atrybutów dla danego zasobu możesz też wysyłać zapytania dotyczące powiązane dane:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

To zapytanie filtruje tylko kampanie o stanie PAUSED i uzyskały ponad 1000 wyświetleń przy sortowaniu według identyfikatora kampanii. Każdy otrzymana w ten sposób funkcja GoogleAdsRow miałaby pole metrics wypełnione wartością wybranych danych.

Listę danych, do których można utworzyć zapytania, znajdziesz w Metrics dokumentacji.

Zapytania dotyczące segmentów

Oprócz wybranych atrybutów dla danego zasobu możesz też wysyłać zapytania dotyczące powiązane segmenty:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

Podobnie jak w przypadku zapytań o dane, to zapytanie filtruje tylko te kampanie, które mają stan PAUSED i uzyskały ponad 1000 wyświetleń; jednak segmentuje dane według daty. Dzięki temu każdy wynik GoogleAdsRow – krotka kampanii z datą Segment. Jest Warto pamiętać, że segmentacja powoduje podział wybranych danych, pogrupowanie ich według w klauzuli SELECT.

Listę segmentów, do których można tworzyć zapytania, znajdziesz w Segments dokumentacji.

Zapytanie o atrybuty powiązanego zasobu

W zapytaniu dotyczącym danego zasobu możesz mieć możliwość złączenia z innymi powiązanymi zasobami jeśli są dostępne. Są to tzw. „przypisane zasoby”, zasobów”. Możesz domyślnie złączyć z przypisanymi zasobami, wybierając w zapytaniu.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

To zapytanie nie tylko wybiera atrybuty kampanii, ale też pobiera powiązane atrybutów z każdej wybranej kampanii. Każda wartość GoogleAdsRow oznacza obiektu campaign z wybranymi atrybutami kampanii oraz wybrany atrybut strategii ustalania stawek: bidding_strategy.name.

Aby sprawdzić, jakie przypisane zasoby są dostępne dla zapytań dotyczących kampanii, zapoznaj się z dokumentacją referencyjną Campaign.

Mutowanie na podstawie wyników zapytania

Wysyłając zapytanie o dany zasób, możesz natychmiast pobrać zwrócone zasoby jako obiekty, zmodyfikować je, a następnie odesłać z powrotem do metody mutate w usłudze zasobu. Poniżej znajduje się przykładowy przepływ pracy:

1. Wykonaj zapytanie dotyczące wszystkich kampanii, które obecnie mają stan PAUSED i zawierają więcej niż 1000.
2. Pobierz obiekt Campaign z pola campaign każdego obiektu GoogleAdsRow w odpowiedź.
3. Zmień stan każdej kampanii z PAUSED na ENABLED.
4. Zadzwoń pod numer CampaignService.MutateCampaigns ze zmodyfikowanymi kampaniami, by je zaktualizować.

Metadane pola

Zapytania wysyłane do GoogleAdsFieldService służą do pobierania metadanych pola. Te informacje pomogą Ci zrozumieć, jak pola mogą być używane razem. w zapytaniu. Dane są dostępne za pośrednictwem interfejsu API i zapewniają metadanych niezbędnych do weryfikacji lub utworzenia zapytania, co umożliwia programistom automatycznie. Oto typowe zapytanie o metadane:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

Ciąg <INSERT_RESOURCE_OR_FIELD> w tym zapytaniu możesz zastąpić zasób (taki jak customer lub campaign) lub pole (takie jak campaign.id, metrics.impressions lub ad_group.id).

Ważne: pamiętaj, że w tym zapytaniu nie ma klauzuli FROM.

Listę pól, do których można tworzyć zapytania, znajdziesz w GoogleAdsField dokumentacji.

Przykłady kodu

Biblioteki klienta zawierają przykłady użycia biblioteki Język zapytań Google Ads w: GoogleAdsService. Folder Podstawowe operacje zawiera takie jak GetCampaigns, GetKeywords i SearchForGoogleAdsFields. Folder reporting zawiera przykład GetKeywordStats.