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 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 nowy punkt końcowy wersji głównej Twój kod może wymagać zmian. Jeśli korzystasz z 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ść:

• 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 0 na --.
• 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 parametr vMAJOR_MINOR będzie miał wartość MINOR większą niż zero.

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 dodatkowe 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.