Jak opisano w przewodniku po strukturze interfejsu API, każdy zasób najwyższego poziomu w interfejsie Google Ads API ma odpowiadającą mu usługę odpowiadającą danemu typowi zasobu, która umożliwia modyfikowanie jego wystąpień.
W tym przewodniku użyjemy usługi CampaignService, aby zademonstrować modyfikowanie obiektów Campaign, ale te same zasady dotyczą wszystkich innych usług związanych z danym typem zasobu.
Zmiana obiektów
Każda usługa związana z konkretnym typem zasobu będzie mieć metodę mutate, która przyjmuje prośbę o zmianę. Ta prośba zawiera:
customerId- zbiór operacji
- Ustawienie typu treści odpowiedzi, które określa, czy zmodyfikowany zasób czy tylko nazwa zasobu ma zostać zwrócona po zmianie.
Na przykład metoda MutateCampaigns klasy CampaignService przyjmuje parametr MutateCampaignsRequest, który składa się z:
customerId- Kolekcja
CampaignOperationobiektów - Pole
response_content_typewskazujące preferowany typ odpowiedzi.
Operacje
Obiekt operacji, np. CampaignOperation, umożliwia określenie działania, które chcesz wykonać na pojedynczym zasobie, przez ustawienie jego pola operation. To pole to pole typu oneof, które składa się z tych atrybutów o typie typu zasobu:
create- Tworzy nową instancję zasobu.
update- Zaktualizuje zasób, aby jego atrybuty były zgodne z atrybutami zasobu
update. Gdy to pole jest ustawione, musisz też ustawićupdate_maskoperacji, która informuje interfejs Google Ads API, które atrybuty należy zmodyfikować podczas operacji aktualizacji. Każda biblioteka klienta ma metodę pomocniczą, która wygeneruje dla Ciebieupdate_mask, jak pokazano w naszych bibliotekach klienta. remove- Usuwanie zasobu.
Ponieważ pole operation jest polem oneof, nie możesz użyć jednej operacji do modyfikowania wielu obiektów. Jeśli np. chcesz utworzyć jedną kampanię i usunąć inną, dodaj do żądania 2 wystąpieni CampaignOperation: jedno z ustawieniem create, a drugie z ustawieniem remove.
Operacje wsadowe
Chociaż pojedyncza operacja może tworzyć, aktualizować lub usuwać tylko 1 zasób, pojedyncza prośba o zmianę może zawierać wiele operacji. Zamiast wysyłać wiele żądań z pojedynczą operacją, zamiast tego złącz operacje w pojedyncze żądanie zmodyfikowania.
Jeśli np. chcesz utworzyć 10 kampanii, wyślij pojedynczy obiekt MutateCampaignsRequest, który zawiera 10 obiektów CampaignOperation.
Zmiana odpowiedzi
Dane zwracane w odpowiedzi zależą od tego, co zostało przesłane w polu response_content_type żądania modyfikacji. Jeśli np. podano wartość MUTABLE_RESOURCE, odpowiedź będzie zawierać tylko pola zmienne w kampanii. Następnie możesz wprowadzić dalsze zmiany w tym obiekcie zasobu bez konieczności jego odtwarzania.
Błędy funkcji mutate
Operacje w danym żądaniu zmodyfikowania zostaną zastosowane na koncie Google Ads tylko wtedy, gdy wszystkie operacje w tym żądaniu zakończą się powodzeniem. Zapoznaj się z przewodnikiem po typowych błędach, aby poznać listę typowych błędów i sposoby ich rozwiązywania.