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