Wersjonowanie semantyczne
Interfejs Google Ads API korzysta z semantycznej obsługi wersji, która obejmuje wersję główną i wersję podrzędną. Format wersji to MAJOR.MINOR lub vMAJOR_MINOR. Na przykład v21_0 to wersja główna, a v21_1 to wersja podrzędna.
Informacje o poprzednich wersjach znajdziesz w informacjach o wersji.
Wersje główne
Wersje główne wprowadzają zmiany powodujące niezgodność wsteczną.
Wersja będzie kończyć się zerem w formacie vX_0, gdzie X to numer wersji głównej.
Każda główna wersja ma oddzielny punkt końcowy. W tym przykładzie adresu URL X to numer wersji głównej.
https://googleads.googleapis.com/vX
Jeśli przechodzisz na nową wersję główną ze starszej, po przełączeniu się na punkt końcowy nowej wersji głównej Twój kod może wymagać zmian. Jeśli używasz naszych bibliotek klienta, zaktualizuj je do najnowszej wersji. Gdy pojawi się nowa wersja główna, udostępnimy przewodnik migracji, który pomoże Ci naprawić wszelkie zmiany powodujące problemy w kodzie.
Przykłady zmian powodujących niezgodność:
- Usunięcie lub zmiana nazwy usługi, interfejsu, pola, metody lub wartości wyliczenia.
- zmiana typu pola;
- Zmiana formatu nazwy zasobu.
- Zmiana formatu adresu URL w definicji HTTP.
- Zmiana formatów wyjściowych, np. zmiana wartości domyślnej z
0na--. - Zmiana przyczyny błędu zwracanej z A na B.
Wersje podrzędne
Wersje podrzędne wprowadzają tylko zmiany zgodne wstecznie. W przypadku wersji podrzędnej wartość vMAJOR_MINOR będzie większa od zera.MINOR
Gdy zostanie wydana wersja podrzędna, używany już punkt końcowy zostanie automatycznie zaktualizowany. Nie spowoduje to uszkodzenia kodu. Możesz nadal korzystać z dotychczasowych bibliotek klienta.
Wersje podrzędne zawierają nowe funkcje lub aktualizacje, które nie wpływają na istniejący kod. Jeśli chcesz korzystać z tych nowych funkcji, zaktualizuj biblioteki klienta do najnowszej wersji.
Zachody słońca
Okresowo starsze wersje interfejsu Google Ads API będą musiały zostać wycofane. Gdy wersja będzie się zbliżać do wycofania, opublikujemy powiadomienia na blogu dla deweloperów. Harmonogram wycofywania jest aktualizowany o przyszłe daty wyłączenia.