Obsługa wersji

Wersja semantyczna

Interfejs Google Ads API stosuje semantyczną obsługę wersji, w której występują główna i podrzędna wersja. Format wersji to MAJOR.MINOR lub vMAJOR_MINOR. Na przykład v18_0 jest wersją główną, a v18_1 – podrzędną.

Informacje o poprzednich wersjach znajdziesz w informacjach o wersji.

Wersje główne

Duże wersje wprowadzają zmiany powodujące niezgodność wsteczną. Wersja kończy się zerem w formacie vX_0, gdzie X to numer głównej wersji.

Każda główna wersja ma osobny punkt końcowy. Oto przykład adresu URL, w którym X to numer wersji głównej.

https://googleads.googleapis.com/vX

Jeśli przechodzisz na nowszą wersję główną, Twój kod może wymagać zmian po przejściu na punkt końcowy nowej wersji głównej. Jeśli używasz naszych bibliotek klienta, zaktualizuj je do najnowszej wersji. Gdy zostanie wydana nowa wersja główna, udostępnimy przewodnik po migracji, który pomoże Ci naprawić wszelkie zmiany 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. z 0 na -- jako wartość domyślna.
• Zmiana zwracanego powodu błędu z A na B.

Wersje podrzędne

Wersje drobne wprowadzają tylko zmiany zgodne wstecznie. W przypadku wersji podrzędnej parametrvMAJOR_MINOR będzie miał wartość MINOR większą od 0.

Gdy zostanie wydana nowa wersja podrzędna, punkt końcowy, który jest już używany, zostanie automatycznie zaktualizowany. Nie spowoduje to uszkodzenia kodu. Nadal możesz używać dotychczasowych 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, zaktualizuj biblioteki klienta do najnowszej wersji.

Zachody słońca

Co jakiś czas wycofujemy starsze wersje interfejsu Google Ads API. Gdy zbliża się termin wycofania danej wersji, opublikujemy o tym powiadomienie na blogu dla deweloperów. Harmonogram wycofywania jest aktualizowany o przyszłe daty wycofania.