Zgodnie z Przewodnikiem po strukturze interfejsu API każdy zasób najwyższego poziomu w interfejsie Google Ads API ma odpowiednią usługę określonego typu, która obsługuje:
- Modyfikowanie instancji zasobu
- Pobieram 1 instancję zasobu do sprawdzenia
W tym przewodniku użyjemy CampaignService, aby przeprowadzić demonstrację modyfikacji i sprawdzania obiektów Campaign, ale te same pojęcia są stosowane do wszystkich innych usług związanych z konkretnymi zasobami.
Zmienianie obiektów
Każda usługa określonego typu zasobów ma metodę mutacji, która akceptuje żądanie mutacji. To żądanie składa się z:
customerId- Zbiór operacji
- Ustawienie typu treści odpowiedzi, które określa, czy po mutacji zostać zwrócony zmodyfikowany zasób lub tylko nazwa zasobu.
Na przykład metoda MutateCampaigns CampaignService akceptuje MutateCampaignsRequest, który składa się z:
customerId- Kolekcja
CampaignOperationobiektów - Pole
response_content_typewskazujące preferowany typ odpowiedzi.
Zarządzanie
Obiekt operacji, taki jak CampaignOperation, pozwala określić działanie, które chcesz wykonać na pojedynczym zasobie, ustawiając jego pole operation. To pole jest polem jednego z tymi atrybutami, których typem zasobu jest:
create- Tworzy nowe wystąpienie zasobu.
update- Aktualizuje zasób, aby pasował do atrybutów zasobu
update. Po ustawieniu tego pola musisz też ustawićupdate_maskoperacji, która informuje interfejs Google Ads API, które atrybuty mają być modyfikowane podczas aktualizacji. Każda biblioteka klienta ma własny zestaw narzędzi lub narzędzi pomocniczych, które służą do generowaniaupdate_mask. Przykłady znajdziesz w naszych bibliotekach. remove- Usuwa zasób.
Pole operation jest polem oneof, dlatego nie możesz za pomocą jednej operacji modyfikować wielu obiektów. Jeśli np. chcesz utworzyć jedną kampanię i usunąć inną, dodaj do żądania 2 wystąpienia CampaignOperation: jedno z ustawionym create, a drugie z ustawionym remove.
Operacje grupowania
Pojedyncza operacja umożliwia tworzenie, aktualizowanie i usuwanie tylko jednego zasobu, ale jedno żądanie mutacji może zawierać wiele operacji. Zalecamy połączenie operacji w jedno żądanie mutacji, a nie wysyłanie wielu żądań mutacji, które zawierają pojedynczą operację.
Jeśli np. chcesz utworzyć 10 kampanii, musisz wysłać pojedynczy MutateCampaignsRequest zawierający 10 obiektów CampaignOperation.
Mutowanie odpowiedzi
To, co jest zwracane w odpowiedzi, zależy od tego, co zostało wysłane w response_content_type żądania mutacji. Jeśli na przykład określono element MUTABLE_RESOURCE, odpowiedź będzie zawierać tylko zmienne pola w kampanii. Następnie możesz dokonać mutacji dodatkowych w tym obiekcie zasobów bez konieczności ich odtwarzania.
Błędy zmian
Operacje w danym żądaniu mutacji będą stosowane na koncie Google Ads tylko wtedy, gdy każda operacja będzie zakończona. Zapoznaj się z przewodnikiem po typowych błędach, gdzie znajdziesz listę typowych błędów i sposoby ich naprawienia.
Sprawdzanie obiektów za pomocą opcji (wycofano)
Oprócz zmiany obiektów każda usługa określonego typu ma też metodę get do pobierania wszystkich atrybutów jednego zasobu.
Ta metoda akceptuje żądania pobierania, których tylko atrybut to resource_name.
Metody pobierania to wygodne w obsłudze interfejsy API Google Ads, które ułatwiają pobieranie wszystkich atrybutów pojedynczego obiektu. To doskonałe narzędzie do poznawania interfejsu API i sprawdzania pojedynczych obiektów pod kątem debugowania lub edukacji, ale Twoja aplikacja nie powinna używać metod pobierania obiektów do przetwarzania lub raportowania. Zamiast tego możesz użyć atrybutu GoogleAdsService, ponieważ umożliwia on pobieranie tylko określonych atrybutów obiektów. Pozwala też pobierać wskaźniki wydajności i umożliwia strumieniowe przesyłanie dużych zbiorów wyników. Jeśli aplikacja wysyła dużą liczbę żądań, możesz napotkać ograniczenia liczby żądań.