GoogleAdsService
to ujednolicony obiekt.
pobierania i raportowania w ramach interfejsu Google Ads API. Usługa udostępnia metody, które:
- Pobieranie określonych atrybutów obiektów.
- Pobieranie danych o wydajności obiektów na podstawie zakresu dat.
- Porządkuj obiekty według ich atrybutów.
- Aby wskazać obiekty, które mają być zwracane w odpowiedzi, użyj warunków.
- Ogranicz liczbę zwracanych obiektów.
GoogleAdsService
może zwracać wyniki w tych terminach:
na dwa sposoby:
GoogleAdsService.SearchStream
zwraca wszystkie wiersze w pojedynczej odpowiedzi strumieniowej, co jest bardziej wydajne w przypadku dużych (ponad 10 000 wierszy) zestawów wyników. To może być bardziej odpowiednie jeśli aplikacja wsadowa chce pobrać jak najszybciej jak to tylko możliwe.GoogleAdsService.Search
– rozpada się dużych ilości odpowiedzi w proste strony z wynikami. Może być więcej odpowiednie, jeśli interaktywna aplikacja wyświetla stronę wyników obecnie się znajdujesz.
Dowiedz się więcej o stronicowaniu i przesyłaniu strumieniowym.
Poproś
Metoda wyszukiwania wymaga
SearchGoogleAdsRequest
, która składa się z:
tych atrybutów:
customer_id
- Język zapytań Google Ads
query
, który wskazuje zasób, o które zasoby ma być wykonywane zapytanie, o atrybuty segmenty i dane do pobrania oraz warunki używane do ograniczania które obiekty są zwracane; - (tylko w
GoogleAdsService.Search
) Apage_size
, aby wskazać, ile obiektów do zwrócenia w pojedynczej odpowiedzi, gdy za pomocą stronicowania. - (tylko w
GoogleAdsService.Search
) opcjonalniepage_token
, aby pobrać następną grupę wyników, jeśli używasz stronicowanie.
Więcej informacji o języku zapytań Google Ads znajdziesz w artykule Język zapytań Google Ads .
Przetwarzanie odpowiedzi
GoogleAdsService
zwraca listę
GoogleAdsRow
obiektów.
Każdy element GoogleAdsRow
reprezentuje obiekt zwrócony przez zapytanie i składa się z elementu
zestawu atrybutów uzupełnionych na podstawie pól żądanych w
Klauzula SELECT
. Atrybuty, których nie ma w klauzuli SELECT
, nie są
została wypełniona w obiektach GoogleAdsRow
w odpowiedzi.
Na przykład chociaż ad_group_criterion
ma atrybut status
, atrybut
Pole status
atrybutu ad_group_criterion
wiersza nie jest wypełnione w
odpowiedź dla zapytania, w którym klauzula SELECT
nie zawiera
ad_group_criterion.status
Podobnie atrybut campaign
wiersza to
nie jest wypełniona, jeśli klauzula SELECT
nie zawiera żadnych pól z metody
campaign
zasób.
Każdy element typu GoogleAdsRow
może mieć inne atrybuty i dane z innego wiersza
w tym samym zestawie wyników; dlatego wiersze powinny być postrzegane jako obiekty, a nie
stałe wiersze tabeli.
NIEZNANY typ wyliczeniowy
Zasoby zwracane z typem UNKNOWN
nie są w pełni obsługiwane
tę wersję interfejsu API. Te zasoby mogły zostać utworzone w inny sposób
takich jak interfejs Google Ads. Możesz wybrać wskaźniki, gdy zasób ma
typu UNKNOWN
, ale nie można wprowadzać mutacji do zasobu za pomocą interfejsu API. An
przykładem może być wprowadzenie nowej kampanii lub reklamy w interfejsie, ale
nie jest obsługiwana w wersji interfejsu API, której dotyczy zapytanie.
Oto kilka kwestii, o których warto pamiętać:
- Zasób typu
UNKNOWN
może być obsługiwany później lub pozostaćUNKNOWN
bez ograniczeń czasowych. - Nowe obiekty typu
UNKNOWN
mogą pojawić się w każdej chwili. Te obiekty są zgodne wstecznie, ponieważ wartość wyliczenia jest już dostępna. Zasoby zostaną udostępnione wraz z udostępnieniem. Dzięki temu dokładne dane na temat konta. ZasóbUNKNOWN
może się wyświetlić z tych powodów: nowe działania na koncie za pomocą innych interfejsów lub gdy zasób nie jest już obsługiwany. - Do
UNKNOWN
zasobów mogą być dołączone szczegółowe dane, które są i nie można ich przeszukiwać. - Zasoby usługi
UNKNOWN
są zwykle w pełni widoczne w interfejsie Google Ads. - W zasobach
UNKNOWN
zwykle nie można wprowadzać mutacji.
Podział na segmenty
Odpowiedź będzie zawierać po jednym elemencie GoogleAdsRow
dla każdej kombinacji
:
- Instancja głównego zasobu określonego w klauzuli
FROM
- Wartość każdego wybranego pola
segment
Na przykład odpowiedź na zapytanie, które wybiera atrybut FROM campaign
i zawiera
segments.ad_network_type
i segments.date
w klauzuli SELECT
spowoduje to
zawierają po jednym wierszu na każdą kombinację tych elementów:
campaign
segments.ad_network_type
segments.date
Wyniki są niejawnie podzielone na segmenty według poszczególnych instancji głównego zasobu, a nie według wartości poszczególnych wybranych pól. Na przykład
SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS
tworzy po 1 wierszu na kampanię, a nie po 1 wierszu na odrębną wartość kolumny
campaign.status
.