Obsługa wersji

Wersjonowanie semantyczne

Interfejs Google Ads API korzysta z wersjonowania semantycznego, które obejmuje wersję główną i podrzędną. Format wersji to MAJOR.MINOR lub vMAJOR_MINOR. Na przykład v25_0 to wersja główna, a v25_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ści wsteczne. Wersja będzie kończyć się zerem w formacie vX_0, gdzie X to numer wersji głównej.

Każda wersja główna ma osobny punkt końcowy. W tym przykładowym adresie URL 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 może być konieczne wprowadzenie zmian w kodzie. Jeśli używasz naszych bibliotek klienta, uaktualnij je do najnowszej wersji. Gdy pojawi się wersja główna, udostępnimy przewodnik migracji, który pomoże Ci naprawić wszelkie zmiany powodujące niezgodności w kodzie.

Przykłady zmian powodujących niezgodności:

• Usuwanie 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 0 na --.
• Zmiana przyczyny błędu zwracanej z A na B.

Wersje podrzędne

Wersje podrzędne wprowadzają tylko zmiany zgodne wstecz. W przypadku wersji podrzędnej, vMAJOR_MINOR będzie mieć numer MINOR większy od zera.

Gdy pojawi się wersja podrzędna, używany punkt końcowy zostanie automatycznie zaktualizowany. Nie spowoduje to przerwania działania kodu. Możesz nadal używać dotychczasowych bibliotek klienta.

Wersje podrzędne zawierają nowe funkcje lub aktualizacje, które nie wpływają na dotychczasowy kod. Jeśli chcesz korzystać z tych nowych funkcji, uaktualnij swoje 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 wycofania.