Google Ads API Explorer

Google Ads API Explorer – это интерактивная среда выполнения, которая позволяет создавать и отправлять запросы к API прямо из браузера. Он встроен в справочную документацию и позволяет тестировать определенные сервисы и методы, не написав ни строчки кода. При этом вам не нужно беспокоиться о сложностях, связанных с аутентификацией OAuth 2.0 и форматированием полезной нагрузки JSON.

Преимущества

  • Тестирование без кода. Выполняйте вызовы API (как на чтение, так и на запись) прямо из документации, не настраивая локальную среду разработки.
  • Обнаружение протокола. Изучите структуру HTTP-запросов и ответов, чтобы понять, как работает API.
  • Прототипирование с минимальными усилиями. Проверяйте поведение конечных точек и анализируйте необработанные ответы API непосредственно перед реализацией логики в приложении.
  • Упрощенная аутентификация. Инструмент автоматически управляет процессами OAuth 2.0, позволяя вам сосредоточиться на запросах к API, а не на управлении учетными данными.

Начать

  1. Перейдите к документации. Откройте справочную документацию и выберите сервис и метод, которые хотите протестировать, например GoogleAdsService/Search.
  2. Откройте Explorer. Найдите панель Попробовать этот метод в правой части страницы.
  3. Настройте запрос:
    • Укажите необходимые параметры запроса, например customerId, и разверните раздел Заголовки, чтобы добавить необязательные HTTP-заголовки, например login-customer-id (требуется только при доступе к аккаунту через управляющий аккаунт). Обратите внимание, что токены разработчика (developer-token) перестали поддерживаться 9 сентября 2026 года и игнорируются серверами API, хотя вы по-прежнему можете ввести значение, если это требуется в форме.
    • Если метод требует полезной нагрузки, например для операций search или mutate, определите тело запроса с помощью интерактивного редактора JSON.
  4. Выполнение. Нажмите Execute (Выполнить), чтобы отправить запрос. Инструмент показывает полный HTTP-запрос и ответ JSON от API.

Основные функции

  • Выполнение в реальном времени. Выполняйте операции search и mutate в реальном времени в рабочих или тестовых аккаунтах.
  • Форматирование полезной нагрузки JSON. Интерактивно создавайте сложные объекты JSON для запросов. Инструмент будет выделять обязательные поля и допустимые структуры схем.
  • Маски полей. Протестируйте логику update_mask, чтобы увидеть, как на практике работают частичные обновления ресурсов.
  • Проверка ошибок. Просматривайте подробные сообщения об ошибках и коды (например, QUERY_ERROR или AUTHENTICATION_ERROR) в необработанном ответе, чтобы быстрее устранять неполадки.
  • Экспорт кода. Экспортируйте команды curl, необработанные HTTP-запросы или примеры кода JavaScript из расширенного представления API Explorer.

Примеры использования

  • Проверка настроек аккаунта. Быстро получайте конфигурации или метаданные на уровне аккаунта, выполняя запрос GoogleAdsService/Search к ресурсу customer.
  • Тестирование изменений. Проверяйте, успешно ли создана кампания или обновлен бюджет, прежде чем развертывать код в рабочей среде.
  • Отладка GAQL. Используйте Проводник, чтобы выполнить строку языка запросов Google Рекламы (GAQL) и убедиться, что возвращенная структура JSON соответствует ожиданиям вашего приложения.
  • Проверка протокола. Проверьте точные заголовки HTTP и вложенность JSON, необходимые для определенной версии API.