Pobieram obiekty

GoogleAdsService to ujednolicona usługa pobierania i raportowania danych w interfejsie Google Ads API. Usługa obejmuje takie metody:

  • Pobieranie określonych atrybutów obiektów.
  • Pobieranie danych o wydajności obiektów na podstawie zakresu dat.
  • Uporządkować obiekty na podstawie ich atrybutów.
  • Określ za pomocą warunków, które obiekty mają być zwracane w odpowiedzi.
  • Ogranicz liczbę zwróconych obiektów.

GoogleAdsService może zwracać wyniki na 2 sposoby:

  • GoogleAdsService.SearchStream zwraca wszystkie wiersze w pojedynczej odpowiedzi na żądanie,która jest bardziej efektywna w przypadku dużych zestawów (ponad 10 000 wierszy). To może być bardziej odpowiednie, jeśli aplikacja wsadowa chce pobrać jak najwięcej danych.
  • GoogleAdsService.Search dzieli duże odpowiedzi na możliwe do zarządzania strony wyników. Ta metoda może okazać się bardziej odpowiednia, jeśli interaktywna aplikacja wyświetli jednocześnie stronę wyników.

Dowiedz się więcej o stronicowaniu i strumieniowaniu.

Zgłaszanie prośby

Metoda wyszukiwania wymaga tagu SearchGoogleAdsRequest, który składa się z tych atrybutów:

  • customer_id.
  • Język zapytań Google Ads query, który określa, do którego zasobu należy wysłać zapytanie, atrybuty, segmenty i dane do pobrania, a także warunki, które mają służyć do ograniczania zwracanych obiektów.
  • (Tylko GoogleAdsService.Search) Apage_size, aby wskazać, ile obiektów ma zostać zwróconych w pojedynczej odpowiedzi podczas korzystania z stronicowania.
  • (Tylko GoogleAdsService.Search) Opcjonalny nagłówek page_token, który pobiera następną grupę wyników przy korzystaniu z metody stronicowania.

Więcej informacji o języku zapytań Google Ads znajdziesz w przewodniku po języku zapytań Google Ads.

Przetwarzam odpowiedź

GoogleAdsService zwraca listę obiektów GoogleAdsRow.

Każdy GoogleAdsRow reprezentuje obiekt zwracany przez zapytanie. Składa się z zestawu atrybutów wypełnianych na podstawie pól podanych w klauzuli SELECT. Atrybuty nieuwzględnione w klauzuli SELECT nie są umieszczane w obiektach GoogleAdsRow w odpowiedzi.

Na przykład, choć atrybut ad_group_criterion ma atrybut status, pole status w atrybucie ad_group_criterion w wierszu nie zostało wypełnione w odpowiedzi na zapytanie, w którym klauzula SELECT nie zawiera ad_group_criterion.status. Podobnie atrybut campaign w wierszu nie zostanie wypełniony, jeśli klauzula SELECT nie zawiera żadnych pól z zasobu campaign.

Każdy element GoogleAdsRow może mieć inne atrybuty i dane z innego wiersza w tym samym zestawie wyników. Wiersze powinny więc być wyświetlane jako obiekty, a nie stałe wiersze tabeli.

NIEZNANE typy wyliczenia

Zasoby zwracane z typem UNKNOWN nie są w pełni obsługiwane w tej wersji interfejsu API. Te zasoby mogły zostać utworzone za pomocą innych interfejsów, np. interfejsu Google Ads. Możesz wybrać wskaźniki, gdy zasób ma typ UNKNOWN, ale nie możesz wprowadzić w nim mutacji za pomocą interfejsu API. Przykładem może być wprowadzenie nowej kampanii lub reklamy w interfejsie, która nie jest obsługiwana w danej wersji interfejsu API, którego dotyczy zapytanie.

Oto kilka kwestii, o których należy pamiętać:

  • Zasób typu UNKNOWN może być obsługiwany później lub pozostać UNKNOWN bez ograniczeń czasowych.
  • W dowolnym momencie mogą pojawić się nowe obiekty typu UNKNOWN. Te obiekty są zgodne wstecznie, ponieważ wartość enum jest już dostępna. Aby mieć pewność, że Twoje konto jest dokładne, wprowadzamy zasoby, w których są one dostępne. Zasób UNKNOWN może być wyświetlany z powodu nowej aktywności na Twoim koncie za pomocą innych interfejsów lub z powodu, że zasób nie będzie już oficjalnie obsługiwany.
  • Do UNKNOWN zasobów możesz dołączyć szczegółowe dane, których można używać do wysyłania zapytań.
  • UNKNOWN zasoby są zazwyczaj w pełni widoczne w interfejsie Google Ads.
  • Zazwyczaj nie można wprowadzić mutacji do UNKNOWN zasobu.

Podział na segmenty

Odpowiedź będzie zawierać jeden element GoogleAdsRow dla każdej kombinacji następujących wartości:

  • instancja głównego zasobu określonego w klauzuli FROM
  • wartość każdego wybranego pola segment

Na przykład odpowiedź na zapytanie, które wybiera FROM campaign i zawiera segments.ad_network_type i segments.date w klauzuli SELECT, zawiera po jednym wierszu na każdą kombinację:

  • campaign
  • segments.ad_network_type
  • segments.date