Pobieram obiekty

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

GoogleAdsService to ujednolicona usługa pobierania i raportowania obiektów z interfejsu Google Ads API. Usługa zawiera te metody:

  • Pobieranie konkretnych atrybutów obiektów.
  • Pobieranie danych o skuteczności obiektów na podstawie zakresu dat.
  • Uporządkuj obiekty na podstawie ich atrybutów.
  • Za pomocą warunków określ, które obiekty mają być zwracane w odpowiedzi.
  • Ogranicz liczbę zwracanych obiektów.

GoogleAdsService może zwrócić wyniki na 2 sposoby:

  • GoogleAdsService.SearchStream zwraca wszystkie wiersze w jednej odpowiedzi na żądanie,która jest większa w przypadku większych (ponad 10 000 wierszy) wyników. Ta opcja może być bardziej odpowiednia, 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. Może to być bardziej odpowiednie, gdy w danym momencie Twoja interaktywna aplikacja wyświetla stronę z wynikami.

Dowiedz się więcej o grupowaniu i strumieniowaniu.

Wysyłanie prośby

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

  • customer_id:
  • Język zapytania Google Ads query, który wskazuje zasób, do którego chcesz przesłać zapytanie, atrybuty, segmenty i dane, które chcesz pobrać, oraz warunki pozwalające na określenie, które obiekty są zwracane.
  • (Tylko GoogleAdsService.Search) Apage_size, aby wskazać, ile obiektów jest zwracanych w pojedynczej odpowiedzi podczas stronicowania.
  • (Tylko GoogleAdsService.Search) Opcjonalne page_token, aby pobrać następną grupę wyników podczas stronicowania.

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

Przetwarzanie odpowiedzi

GoogleAdsService zwraca listę obiektów GoogleAdsRow.

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

Na przykład: mimo że ad_group_criterion ma atrybut status, pole status w wierszu status w atrybucie ad_group_criterion nie jest wypełnione w odpowiedzi na zapytanie, w którym klauzula SELECT nie zawiera klauzuli ad_group_criterion.status. Atrybut wiersza campaign nie jest też wypełniany, jeśli klauzula SELECT nie zawiera żadnych pól z zasobu campaign.

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

NIEZNANE typy enum

Zasoby zwracane jako typ UNKNOWN nie są w pełni obsługiwane w tej wersji interfejsu API. Zasoby te mogły zostać utworzone przy użyciu innych interfejsów, np. interfejsu Google Ads. Możesz wybrać wskaźniki, gdy zasób ma typ UNKNOWN, ale nie możesz zmienić go za pomocą interfejsu API. Przykładem może być wprowadzenie w interfejsie nowej kampanii lub reklamy, ale nieobsługiwana przez wersję interfejsu API, której 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ń.
  • W każdej chwili mogą pojawić się nowe obiekty typu UNKNOWN. Te obiekty są zgodne wstecznie, ponieważ wartość enum jest już dostępna. Wprowadzamy zmiany w tych zmianach, gdy tylko będą one dostępne, dzięki czemu będziesz mieć dokładny widok swojego konta. Zasób UNKNOWN może pojawiać się z powodu nowej aktywności na Twoim koncie przez inne interfejsy lub z tego, że zasób nie będzie już formalnie obsługiwany.
  • Do UNKNOWN zasobu mogą być dołączone szczegółowe dane, których można użyć do wysyłania zapytań.
  • Zasoby UNKNOWN są zwykle w pełni widoczne w interfejsie Google Ads.
  • Zazwyczaj UNKNOWN zasobu nie można zmienić.

podział na segmenty,

Odpowiedź będzie zawierać jeden element GoogleAdsRow dla każdej kombinacji tych elementów:

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

Na przykład odpowiedź na zapytanie zawierające FROM campaign i zawierające segments.ad_network_type oraz segments.date w klauzuli SELECT będzie zawierać jeden wiersz dla każdej kombinacji tych elementów:

  • campaign
  • segments.ad_network_type
  • segments.date