Що змінює Google Ads API Developer Assistant v2.0?

Нещодавно Google представила оновлену версію Google Ads API Developer Assistant v2.0, яка перетворює інструмент із генератора коду на активного партнера для автоматизації та діагностики процесів розробки. Оновлення спрощує інтеграцію з Google Ads API, підвищує надійність роботи та дозволяє розробникам ефективніше працювати з рекламними кампаніями.

Проактивна підтримка та автоматизація

Assistant v2.0 тепер не просто генерує код – він допомагає виявляти проблеми, діагностувати неполадки та автоматизувати рутинні завдання. Серед ключових нововведень:

• Покращена установка та оновлення через одну команду
• Уніфікована структура директорій для коду, CSV-файлів та діагностичних звітів
• Інструменти для перевірки і виправлення помилок у відстеженні офлайн-конверсій
• Підтримка останньої версії API (v23)
• Сесійні хуки для автоматизації робочих процесів
• Покращена валідація GAQL-запитів
• Експериментальна функція Skills для складних процедурних завдань

Спрощена установка та обслуговування

• Однокомандна установка: використовуйте прапорець --install-deps зі скриптами install.sh або install.ps1 для автоматичної інсталяції всіх залежностей (pip, composer, bundler).

• Уніфікована структура директорій: весь код, CSV-експорти та діагностичні звіти тепер зберігаються в одному каталозі saved/ з підкаталогами для зручного доступу.

• Оновлення однією командою: за допомогою update.sh можна швидко оновити API до останньої версії та додати потрібні бібліотеки клієнта.

Діагностика конверсій та підтримка інтеграцій

Assistant v2.0 включає Conversion Troubleshooting & Diagnostics suite для перевірки офлайн-конверсій.

• Новий скрипт: api_examples/collect_conversions_troubleshooting_data.py
• Команда /conversions_support_data створює структуровані діагностичні звіти, виявляє проблемні стани та високі показники відмов, що спрощує звернення до підтримки.

Підтримка Google Ads API v23

Нова версія повністю сумісна з API v23, забезпечує оновлені інтерактивні приклади та оптимізовану роботу з ресурсами й полями, що гарантує готовий до виробництва код.

Сесійні хуки та автоматизація

Assistant додав SessionStart та SessionEnd хуки, що дозволяють:

• Автоматично знаходити конфігураційні файли у $HOME та копіювати їх у директорію проекту
• Виконувати запити на Python, зберігаючи відповідь у бажаній мові користувача
• Безпечно видаляти тимчасові конфігурації після завершення сесії

Покращена валідація GAQL

Assistant тепер краще перевіряє запити GAQL на:

• Логічні помилки перед виконанням
• Обмеження по датах і кінцевих діапазонах
• Складні крайові випадки API

Функція Skills для складних завдань

Skills – це експериментальна функція, яка працює як міні-плагін для складних процедурних завдань. Вона інтегрується з сесійними хуками для автоматизації ініціалізації та очищення процесів.

Чому варто оновити до v2.0

• Зменшення спроб і помилок при інтеграції API
• Прискорене та впевнене відлагодження конверсій і побудова складних звітів
• Підвищення надійності та ефективності роботи розробника

Як почати

• Перше встановлення: клонувати репозиторій та запустити install.sh або install.ps1.
• Оновлення: створити резервну копію користувацького коду з saved_code/ та saved_csv/, видалити стару директорію проекту, повторно клонувати репозиторій та запустити скрипт встановлення.

Читайте статтю англійською мовою.