Zmiana i kontrola obiektów

Zgodnie z Przewodnikiem po interfejsie API każdy zasób najwyższego poziomu w interfejsie Google Ads API ma odpowiednią usługę typową, która obsługuje:

  • Modyfikowanie instancji zasobu
  • Pobieram pojedynczą instancję zasobu do sprawdzenia

W tym przewodniku użyto narzędzia CampaignService do demonstracji modyfikowania i sprawdzania obiektów Campaign, ale te same pojęcia są używane w przypadku wszystkich innych usług zależnego od typu zasobu.

Zmienianie obiektów

Każda usługa specyficzna dla typu zasobu będzie stosować metodę mutacji, która akceptuje żądanie mutacji. Żądanie składa się z:

  • customerId
  • Zbiór operacji
  • Ustawienie typu treści odpowiedzi określające, czy po zmutowaniu zasobu powinien zostać zwrócony zmienny zasób, czy tylko nazwa zasobu.

Na przykład metoda MutateCampaigns elementu CampaignService akceptuje MutateCampaignsRequest, który składa się z:

  • customerId
  • Kolekcja obiektów CampaignOperation
  • Pole response_content_type wskazujące preferowany typ odpowiedzi.

Operacje

Obiekt operacji, taki jak CampaignOperation, umożliwia określenie działania, które chcesz wykonać w przypadku pojedynczego zasobu, ustawiając jego pole operation. To pole zawiera jedno z pól składających się z następujących atrybutów, których typ to typ zasobu:

create
Utworzy nową instancję zasobu.
update
Aktualizuje zasób, aby pasował do atrybutów update. Po ustawieniu tego pola musisz też ustawić update_mask operacji, która informuje interfejs Google Ads API o atrybutach do zmodyfikowania podczas operacji aktualizacji. Każda biblioteka klienta ma metodę praktyczną, która wygeneruje update_mask. Prezentujemy ją w naszych bibliotekach klienta.
remove
Usuwa zasób.

Pole operation jest polem oneof, więc nie możesz modyfikować wielu obiektów za pomocą jednej operacji. Jeśli na przykład chcesz utworzyć jedną kampanię i usunąć inną, dodaj do żądania dwa wystąpienia parametru CampaignOperation: jeden z ustawionym ustawieniem create i drugi z ustawionym ustawieniem remove.

Operacje grupowania

Pojedyncza operacja może tylko utworzyć, zaktualizować lub usunąć jeden zasób, jednak jedno żądanie mutacji może zawierać wiele operacji. Połącz operacje w 1 żądaniu mutacji, zamiast wysyłać wiele żądań mutacji, które zawierają jedną operację.

Jeśli np. chcesz utworzyć dziesięć kampanii, wyślij pojedynczy MutateCampaignsRequest z 10 obiektami CampaignOperation.

Mutacje odpowiedzi

Zawartość odpowiedzi zależy od tego, co zostało wysłane w response_content_type żądania mutacji. Jeśli na przykład określono MUTABLE_RESOURCE, odpowiedź będzie zawierać tylko pola zmienne w kampanii. Następnie możesz wprowadzić mutacje uzupełniające do tego obiektu zasobu bez konieczności jego odtworzenia.

Błędy mutacji

Operacje w konkretnej prośbie zostaną zmodyfikowane na koncie Google Ads tylko wtedy, gdy każda operacja się uda. Zapoznaj się z przewodnikiem po typowych błędach, aby zapoznać się z listą typowych błędów i sposobami ich naprawiania.

Sprawdzanie obiektów za pomocą metody (wycofano)

Oprócz zmiany obiektów każda usługa specyficzna dla typu zasobu wykorzystuje też metodę get do pobierania wszystkich atrybutów jednego zasobu. Ta metoda akceptuje żądania get z atrybutem resource_name.

Metody „get” to wygodne rozwiązanie interfejsu API Google Ads, które ułatwia pobieranie wszystkich atrybutów pojedynczego obiektu. To doskonałe narzędzie do nauki interfejsu API lub sprawdzania poszczególnych obiektów na potrzeby debugowania lub edukacyjnych, ale nie należy używać metod pobierania obiektów do przetwarzania lub raportowania. Zamiast tego użyj tagu GoogleAdsService, ponieważ umożliwia on pobieranie tylko określonych atrybutów obiektów, obsługuje pobieranie danych o wydajności oraz umożliwia strumieniowanie przez duże zbiory wyników. Jeśli aplikacja wysyła dużą liczbę żądań, mogą wystąpić ograniczenia liczby żądań.