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

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

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

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

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

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

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

https://googleads.googleapis.com/vX

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

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

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

Младшие версии

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

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

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

Закаты

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