Pobieram obiekty

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) A page_size, aby wskazać, ile obiektów do zwrócenia w pojedynczej odpowiedzi, gdy za pomocą stronicowania.
  • (tylko w GoogleAdsService.Search) opcjonalnie page_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ób UNKNOWN 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.