Semantyczna obsługa wersji
Interfejs Google Ads API jest zgodny z wersją semantyczną obejmującą wersję główną i podrzędną. Format wersji to MAJOR.MINOR lub vMAJOR_MINOR. Na przykład v17_0 to wersja główna, a v17_1 to wersja podrzędna.
Poprzednie wersje znajdziesz w informacjach o wersji.
Wersje główne
Główne wersje wprowadzają pewne zmiany powodujące niezgodność, niezgodne wstecznie.
Wersja kończy się na 0 i ma format vX_0, gdzie X to numer wersji głównej.
Każda wersja główna ma oddzielny punkt końcowy. Oto przykład adresu URL, w którym X to numer wersji głównej.
https://googleads.googleapis.com/vX
Jeśli uaktualniasz starszą wersję główną, Twój kod może wymagać wprowadzenia zmian po przejściu na nowy punkt końcowy wersji głównej. Jeśli używasz naszych bibliotek klienta, uaktualnij je do najnowszej wersji. Po opublikowaniu wersji głównej otrzymasz przewodnik po migracji, z którego dowiesz się, jak naprawić zmiany powodujące niezgodność w kodzie.
Przykłady zmian powodujących niezgodność:
- usunięcie lub zmiana nazwy usługi, interfejsu, pola, metody bądź wartości wyliczeniowej;
- Zmiana typu pola.
- Zmiana formatu nazwy zasobu.
- Zmiana formatu adresu URL w definicji HTTP.
- zmiana formatu wyjściowego, np. zmiana z „
0” na „--” jako wartości domyślnej; - Zmiana przyczyny błędu zwróconej z A na B.
Wersje podrzędne
Wersje podrzędne wprowadzają tylko zgodne wstecznie zmiany. W przypadku wersji podrzędnej vMAJOR_MINOR wartość MINOR jest większa niż 0.
Po opublikowaniu wersji podrzędnej, który jest już używany, punkt końcowy zostanie automatycznie zaktualizowany. Nie spowoduje to uszkodzenia kodu. Nadal możesz używać istniejących bibliotek klienta.
Wersje podrzędne zawierają nowe funkcje lub aktualizacje, które nie mają wpływu na istniejący kod. Jeśli chcesz korzystać z tych nowych funkcji, uaktualnij biblioteki klienta do najnowszej wersji.
Zachody słońca
Okresowo starsze wersje interfejsu Google Ads API będą wycofywane. Informacje o zbliżającym się wycofaniu danej wersji będziemy publikować na blogu dla programistów. Harmonogram wycofywania jest aktualizowany o daty wycofania w przyszłości.