Obsługa wersji

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 v23_0 to wersja główna, a v23_1 to wersja podrzędna.

Informacje o poprzednich wersjach znajdziesz w informacjach o wersji.

Wersje główne

Wersje główne wprowadzają pewne 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 główna wersja ma osobny 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 błędy w kodzie.

Przykłady zmian powodujących niezgodność:

• Usuwanie lub zmienianie 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 z 0 na -- jako wartości domyślnej.
• Zmiana przyczyny błędu zwracanej z A na B.

Wersje podrzędne

Wersje podrzędne wprowadzają tylko zmiany zgodne wstecznie. W przypadku wersji dodatkowej wartość vMAJOR_MINOR będzie liczbą MINOR większą od zera.

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.