Formatowanie zmian w interfejsie Google Ads API

Format identyfikatora klienta

W interfejsie AdWords API możesz określić swój identyfikator klienta w postaci 10-cyfrowej liczby lub ciągu w formacie XXX-XXX-XXXX. Teraz w interfejsie Google Ads API musisz podać identyfikator klienta w postaci 10 cyfr bez myślników.

Format żądania

W interfejsie API AdWords żądania można przesyłać, korzystając z języka zapytania lub selektora XML. Teraz w interfejsie Google Ads API typ żądania wysyłanego określa określony format żądania.

Aby znaleźć listę jednostek spełniających określony zestaw kryteriów, skorzystaj z języka Google Ads w języku zapytań, by przesłać żądanie do GoogleAdsService. Żadna opcja selektora nie jest obsługiwana w tym przypadku użycia, a wszystkie wyszukiwania są przeprowadzane w tej samej usłudze, niezależnie od typu encji.

Pobierz

Podczas pobierania wszystkich szczegółów określonego elementu, np. kampanii, użyj odpowiedniej usługi (w tym przypadku CampaignService) i podaj nazwę zasobu elementu, który chcesz pobrać. Na przykład nazwa zasobu kampanii ma postać /customers/XXXXXXXXXX/campaigns/YYYYYYYYYY, gdzie XXXXXXXXXX to identyfikator klienta bez myślników, a YYYYYYYYYY to identyfikator kampanii.

Zmień

Mutacje połączeń korzystają z tej samej usługi co połączenia telefoniczne – np. CampaignService służy do mutacji kampanii.

Wprowadzenie zmian w interfejsie API AdWords spowoduje zwrócenie nowego stanu obiektu po zakończeniu operacji. W interfejsie Google Ads API wywołania mutacji zwracają tylko nazwę zasobu mutacji. Jeśli chcesz sprawdzić zmieniony stan obiektu, wykonaj kolejne wywołanie interfejsu API w celu pobrania obiektu.

Zmiana połączeń wymaga operacji, która obejmuje jeden z trzech możliwych parametrów:

Utwórz
Wymaga przekazania obiektu ukończonego, w tym jego nazwy zasobu, wszystkich wymaganych pól i wszystkich opcjonalnych pól, które chcesz ustawić.
Zaktualizuj

Wymaga przekazania obiektu wraz z jego nazwą i wszystkimi polami, które chcesz zmienić, wraz z ich nowymi wartościami.

Wymaga przekazania maski aktualizacji, czyli listy pól, które można modyfikować w tym obiekcie. Dzięki temu możesz użyć wartości zwracanej z poprzedniego wywołania get i zmodyfikować tylko niektóre pola lub utworzyć nowy obiekt i ustawić tylko pola, które chcesz zaktualizować. Biblioteki klienta udostępniają narzędzie pomagające określić maskę aktualizacji w żądaniu aktualizacji.

Usuń

Wymaga tylko nazwy zasobu.

Format odpowiedzi

W interfejsie AdWords API wyszukiwanie i pobieranie pól było jedno i tak samo, ale w interfejsie Google Ads API już tak nie jest. Różnica w parametrach żądania powoduje też zmianę formatów odpowiedzi dla obu działań.

Gdy wyszukujesz za pomocą GoogleAdsService, odpowiedzi będą zawierać 1 GoogleAdsRow dla każdego elementu, który pasował do parametrów wyszukiwania. Każdy wiersz zawiera 1 obiekt, na przykład kampanię, a tylko pola tego obiektu to pola, o które prosisz w zapytaniu.

Podczas pobierania za pomocą określonej usługi, na przykład CampaignService, możesz żądać tylko jednego elementu naraz według nazwy zasobu, a wszystkie pola tego elementu zostaną wypełnione w odpowiedzi.