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

Семантическое управление версиями

API Google Рекламы использует семантическое управление версиями , где есть основная и второстепенная версии. Формат версии — MAJOR.MINOR или vMAJOR_MINOR . Например, v16_0 — это основная версия, а v16_1 — дополнительная версия.

См. примечания к выпуску предыдущих версий.

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

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

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

https://googleads.googleapis.com/vX

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

Примеры критических изменений включают в себя:

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

Второстепенные версии

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

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

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

Закаты

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