Obsługa wersji semantycznych
Interfejs Google Ads API obsługuje semantyczną obsługę wersji, gdy występują wersje główne i podrzędne. Format wersji to MAJOR.MINOR lub vMAJOR_MINOR. Na przykład v16_0 to wersja główna, a v16_1 to wersja podrzędna.
Poprzednie wersje znajdziesz w informacjach o wersji.
Wersje główne
Główne wersje wprowadzają niezgodne wstecznie zmiany.
Taka wersja kończy się ciągiem 0 i ma format vX_0, gdzie X to numer wersji głównej.
Każda wersja główna ma osobny punkt końcowy. To jest 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ą, po przejściu na nowy punkt końcowy wersji głównej Twój kod może wymagać wprowadzenia zmian. Jeśli używasz naszych bibliotek klienta, uaktualnij je do najnowszej wersji. Gdy zostanie opublikowana wersja główna, udostępnimy Ci przewodnik po migracji, z którego dowiesz się, jak naprawić wszelkie zmiany powodujące niezgodność w kodzie.
Przykłady zmian powodujących niezgodność:
- usunięcie lub zmiana nazwy usługi, interfejsu, pola, metody lub wartości wyliczeniowej.
- Zmiana typu pola.
- zmiana formatu nazwy zasobu,
- Zmiana formatu adresu URL w definicji HTTP.
- zmiana formatów wyjściowych, na przykład zmiana z
0na--jako wartości domyślnej; - Zmiana przyczyny błędu zwróconego z A na B.
Wersje podrzędne
W wersjach podrzędnych wprowadzono tylko zmiany zgodne wstecznie. W przypadku wersji podrzędnej wartość vMAJOR_MINOR w polu MINOR będzie większa od zera.
Po opublikowaniu wersji podrzędnej punkt końcowy, który jest już używany, zostanie automatycznie zaktualizowany. Nie spowoduje to uszkodzenia kodu. Możesz nadal korzystać z istniejących bibliotek klienta.
Mniejsze wersje 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 muszą być wycofywane. Informacje o wycofaniu danej wersji będziemy publikować na blogu dla deweloperów. Harmonogram wycofywania jest aktualizowany o daty wycofania w przyszłości.