Obsługa wersji

Obsługa wersji semantycznej

Interfejs Google Ads API jest zgodny z wersją semantyczną, w której jest wersja główna i podrzędna. Wersja to MAJOR.MINOR lub vMAJOR_MINOR. Na przykład v11_0 jest wersją główną, a v11_1 jest wersją podrzędną.

Informacje o poprzednich wersjach znajdziesz w informacjach o wersji.

Główne wersje

Główne wersje wprowadzają pewne zmiany powodujące niezgodności. Wersja kończy się zerem i ma format vX_0, gdzie X jest głównym numerem wersji.

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

https://googleads.googleapis.com/vX

W przypadku uaktualniania ze starszej wersji głównej kod może wymagać zmian po przejściu na nowy punkt końcowy wersji głównej. Jeśli używasz bibliotek klienckich, uaktualnij go do najnowszej wersji. Gdy zostanie opublikowana wersja główna, udostępnimy Ci przewodnik po migracji, który należy wykonać, aby naprawić wszelkie zmiany powodujące niezgodność kodu.

Przykłady zmian powodujących niezgodność:

  • Usunięcie lub zmiana nazwy usługi, interfejsu, pola, metody lub wyliczenia.
  • zmienianie typu pola;
  • zmienianie formatu nazwy zasobu,
  • Zmiana formatu adresu URL w definicji HTTP.
  • zmienianie formatów wyjściowych, np. z 0 na --, jako wartości domyślnej;
  • Zmiana przyczyny błędu zwróconego z A na B.

Wersje podrzędne

W przypadku wersji podrzędnych występują tylko zmiany wsteczne. W przypadku wersji podrzędnej vMAJOR_MINOR MINOR ma liczbę większą niż zero.

Po opublikowaniu wersji pomocniczej punkt końcowy, który jest już używany, zostanie automatycznie zaktualizowany. Nie spowoduje to uszkodzenia kodu. Nadal możesz korzystać z istniejących bibliotek klientów.

Mniejsze wersje obejmują nowe funkcje lub aktualizacje, które nie wpływają na Twój kod. Jeśli chcesz korzystać z tych nowych funkcji, zaktualizuj biblioteki klienta do najnowszej wersji.

Zachody słońca

Czasami starsze wersje interfejsu Google Ads API muszą zostać wycofane. Gdy wersja zostanie wyłączona, powiadomimy o tym na blogu dla deweloperów. Harmonogram wycofywania jest aktualizowany o przyszłe daty zachodu słońca.