Управление версиями

Семантическое версионирование

В API Google Ads используется семантическое версионирование, которое подразумевает разделение на основную и дополнительную версии. Формат версии: MAJOR.MINOR или vMAJOR_MINOR . Например, v20_0 — это основная версия, а v20_1 — дополнительная.

См. заметки о выпуске для прошлых версий.

Основные версии

В основных версиях релиза присутствуют критические, обратно несовместимые изменения. Номер версии будет заканчиваться нулем в формате vX_0 , где X — номер основной версии.

Каждая основная версия имеет отдельную конечную точку. В этом примере URL X — номер основной версии.

https://googleads.googleapis.com/vX

Если вы обновляетесь со старой основной версии, ваш код может потребовать изменений при переходе на новую конечную точку основной версии. Если вы используете наши клиентские библиотеки , обновитесь до последней версии. После выхода основной версии мы предоставим руководство по миграции, с которым вам следует ознакомиться, чтобы исправить любые критические изменения в вашем коде.

Примеры критических изменений:

  • Удаление или переименование службы, интерфейса, поля, метода или значения перечисления.
  • Изменение типа поля.
  • Изменение формата имени ресурса.
  • Изменение формата URL в определении HTTP.
  • Изменение форматов вывода, например изменение с 0 на -- в качестве значения по умолчанию.
  • Изменение причины ошибки с А на Б.

Минорные версии

В минорных версиях вносятся только обратно совместимые изменения. Для минорной версии vMAJOR_MINOR будет иметь номер MINOR больше нуля.

При выпуске младшей версии уже используемая конечная точка будет автоматически обновлена. Это не приведёт к сбоям в работе вашего кода. Вы можете продолжать использовать существующие клиентские библиотеки.

Минорные версии включают новые функции или обновления, которые не влияют на ваш текущий код. Если вы хотите использовать эти новые функции, обновите клиентские библиотеки до последней версии.

Закаты

Периодически устаревшие версии API Google Ads должны быть прекращены. Мы будем публиковать уведомления в блоге разработчиков , когда версия будет прекращена. График прекращения поддержки обновляется с указанием будущих дат прекращения поддержки.