Język zapytań Google Ads może wysyłać zapytania do interfejsu Google Ads API
- Zasoby i powiązane z nimi atrybuty, segmenty i dane za pomocą
GoogleAdsService
Wyszukiwarka lub SearchStream- Wyniki zapytania Google AdsService zawiera listę wystąpień
GoogleAdsRow
, przy czym każdy zasóbGoogleAdsRow
reprezentuje zasób. Jeśli wymagane są jakiekolwiek atrybuty lub dane, wiersz zawiera również te pola. Jeśli zażądano segmentów, w odpowiedzi pojawi się też dodatkowy wiersz dla każdej grupy zasobów zasobu. - Metadane dotyczące dostępnych pól i zasobów w
GoogleAdsFieldService
Ta usługa zawiera katalog pól, których można wysłać, a także szczegółowe informacje o ich zgodności i typie.
Wynik zapytania
GoogleAdsFieldService
to lista instancjiGoogleAdsField
, przy czym każda sekcjaGoogleAdsField
zawiera szczegółowe informacje o żądanym polu.
Zapytanie o atrybuty zasobu
Poniżej przedstawiamy podstawowe zapytanie dotyczące atrybutów zasobu kampanii, ilustrujące sposób zwracania identyfikatora, nazwy i stanu kampanii:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
To zapytanie jest uporządkowane według identyfikatora kampanii. Każdy wynik GoogleAdsRow
będzie reprezentować obiekt campaign
zawierający wybrane pola (w tym ten resource_name
).
Aby dowiedzieć się, jakie inne pola są dostępne w przypadku zapytań dotyczących kampanii, zapoznaj się z dokumentacją referencyjną Campaign
.
Zapytanie o wskaźniki
Oprócz wybranych atrybutów danego zasobu możesz też wysyłać zapytania dotyczące powiązanych wskaźników:
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, które mają stan PAUSED
i uzyskały ponad 1000 wyświetleń, uporządkowane według identyfikatora kampanii. W każdym wyniku GoogleAdsRow
znajdowałoby się pole metrics
z wybranymi danymi.
Listę danych, których można użyć do wysyłania zapytań, znajdziesz w dokumentacji usługi Metrics
.
Zapytania o segmenty
Oprócz wybranych atrybutów danego zasobu możesz też wysyłać zapytania dotyczące powiązanych segmentów:
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 kampanie, które mają stan PAUSED
i miały ponad 1000 wyświetleń. Jednak zapytanie to dzieli dane według daty. Dzięki temu każdy wynik GoogleAdsRow
będzie mnogością kampanii i datą Segment
. Pamiętaj, że podział na segmenty dzieli wybrane dane według grupowania w klauzuli SELECT.
Listę segmentów, które można wysyłać do zapytań, znajdziesz w dokumentacji narzędzia Segments
.
Zapytanie o atrybuty powiązanego zasobu
W zapytaniu dotyczącym danego zasobu możesz dołączyć do innych powiązanych zasobów, jeśli są dostępne. Te powiązane materiały są nazywane "przypisanymi zasobami". Możesz dołączyć bezpośrednio do przypisanych zasobów, wybierając atrybut 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 atrybuty z każdej wybranej kampanii. Każdy wynik GoogleAdsRow
jest obiektem campaign
, który uzupełnia wybrane atrybuty kampanii, a także atrybut wybranej strategii ustalania stawek bidding_strategy.name
.
Aby sprawdzić, jakie zasoby są dostępne w przypadku zapytań dotyczących kampanii, zapoznaj się z dokumentacją referencyjną Campaign
.
Mutacja na podstawie wyników zapytania
Wykonując zapytania o konkretny zasób, możesz od razu pobrać zwrócone wyniki jako obiekty, zmodyfikować je i wysłać z powrotem do metody mutacji w tej usłudze. Oto przykładowy przepływ pracy:
- Wyślij zapytanie do wszystkich kampanii, które są obecnie
PAUSED
i których liczba wyświetleń jest większa niż 1000. - Pobierz obiekt
Campaign
z polacampaign
każdego elementuGoogleAdsRow
w odpowiedzi. - Zmień stan każdej kampanii z
PAUSED
naENABLED
. - Aby je zaktualizować, wywołaj
CampaignService.MutateCampaigns
ze zmienionymi kampaniami.
Metadane pola
Zapytania wysyłane do GoogleAdsFieldService
służą do pobierania metadanych pól.
Dzięki temu możesz się dowiedzieć, jak można używać pól w poszczególnych zapytaniach. Dane są dostępne w interfejsie API i dostarczają metadane niezbędne do sprawdzania i kompilowania zapytania, dzięki czemu programiści mogą to zrobić w sposób zautomatyzowany. Oto typowe zapytanie o metadane:
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"
Zapytanie <INSERT_RESOURCE_OR_FIELD>
w tym zapytaniu możesz zastąpić zasobem (takim jak customer
lub campaign
) albo polem (takim jak campaign.id
, metrics.impressions
lub ad_group.id
).
Listę pól, do których można wysyłać zapytania, znajdziesz w dokumentacjiGoogleAdsField
.
Przykłady kodu
Biblioteki klienta zawierają przykłady użycia języka zapytań Google Ads w języku GoogleAdsService
. Folder Operacje podstawowe zawiera przykłady, takie jak GetCampaigns
, GetKeywords
i SearchForGoogleAdsFields
.
Folder reporting zawiera przykład GetKeywordStats
.