Семантическое управление версиями
Google Ads API придерживается семантического управления версиями , где есть основная и дополнительная версии. Формат версии — MAJOR.MINOR или vMAJOR_MINOR . Например, v13_0 — основная версия, а v13_1 — дополнительная версия.
См. примечания к выпуску для прошлых версий.
Основные версии
Основные версии выпуска содержат некоторые критические, обратно несовместимые изменения. Версия будет заканчиваться нулем в формате vX_0 , где X — основной номер версии.
Каждая основная версия имеет отдельную конечную точку. Это пример URL-адреса, где X — номер основной версии.
https://googleads.googleapis.com/vX
Если вы обновляете более старую основную версию, ваш код может потребовать изменений при переходе на конечную точку новой основной версии. Если вы используете наши клиентские библиотеки , обновите их до последней версии. Когда будет выпущена основная версия, мы предоставим вам руководство по миграции, которое вы должны использовать, чтобы исправить любые критические изменения в вашем коде.
Примеры критических изменений включают в себя:
- Удаление или переименование службы, интерфейса, поля, метода или значения перечисления.
- Изменение типа поля.
- Изменение формата имени ресурса.
- Изменение формата URL в определении HTTP.
- Изменение форматов вывода, например изменение с
0на--в качестве значения по умолчанию. - Изменение причины ошибки с A на B.
Второстепенные версии
Второстепенные версии вносят только обратно совместимые изменения. Для дополнительной версии vMAJOR_MINOR будет иметь номер MINOR больше нуля.
При выпуске дополнительной версии уже используемая конечная точка будет автоматически обновлена. Это не приведет к поломке вашего кода. Вы можете продолжать использовать существующие клиентские библиотеки.
Второстепенные версии включают новые функции или обновления, которые не влияют на ваш существующий код. Если вы хотите использовать эти новые функции, обновите свои клиентские библиотеки до последней версии.
Закаты
Время от времени старые версии Google Ads API необходимо удалять. Мы будем публиковать уведомления в блоге разработчиков , когда версия подходит к концу. График устаревания обновляется с учетом будущих дат истечения срока действия.