Semantyczna obsługa wersji
Interfejs Google Ads API jest zgodny z obsługą wersji semantycznych, jeśli występuje
wersję dur i moll. Format wersji to MAJOR.MINOR lub
vMAJOR_MINOR Na przykład v17_0 jest wersją główną, a
v17_1 to wersja podrzędna.
Poprzednie wersje znajdziesz w informacjach o wersji.
Wersje główne
Główne wersje wprowadzają pewne zmiany powodujące niezgodność, niezgodne wstecznie.
Wersja kończy się na 0 i ma format vX_0, gdzie X to główna
numer wersji.
Każda wersja główna ma oddzielny punkt końcowy. To jest przykład adresu URL, w którym
X to numer wersji głównej.
https://googleads.googleapis.com/vX
Jeśli przeprowadzasz uaktualnienie ze starszej wersji głównej, Twój kod może wymagać zmienia się po przejściu do nowego punktu końcowego wersji głównej. Jeśli używasz biblioteki klienta, a następnie uaktualnij ją do najnowszej wersji. Po opublikowaniu wersji głównej udostępnimy przewodnik po migracji, w którym należy wprowadzić poprawki w kodzie.
Przykłady zmian powodujących niezgodność:
- usunięcie lub zmiana nazwy usługi, interfejsu, pola, metody bądź wartości wyliczeniowej;
- Zmiana typu pola.
- Zmiana formatu nazwy zasobu.
- Zmiana formatu adresu URL w definicji HTTP.
- zmiana formatu wyjściowego, np. zmiana z „
0” na „--” jako wartości domyślnej; - Zmiana przyczyny błędu zwróconej z A na B.
Wersje podrzędne
Wersje podrzędne wprowadzają tylko zgodne wstecznie zmiany. W przypadku wersji podrzędnej
Kolumna vMAJOR_MINOR miałaby liczbę MINOR większą niż 0.
Po opublikowaniu wersji podrzędnej, używany już punkt końcowy zostaną automatycznie zaktualizowane. Nie spowoduje to uszkodzenia kodu. Dostępne opcje nadal korzystać z istniejących bibliotek klienta.
Wersje podrzędne zawierają nowe funkcje lub aktualizacje, które nie wpływają na istniejącego kodu. Jeśli chcesz korzystać z tych nowych funkcji, biblioteki klienta do najnowszej wersji.
Zachody słońca
Okresowo starsze wersje interfejsu Google Ads API będą wycofywane. Będziemy publikować powiadomienia na blogu dla programistów gdy wersja jest bliska wycofania. harmonogram wycofywania jest aktualizowany po wycofaniu usługi w przyszłości daty.