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. Откройте Проводник: найдите панель «Попробуйте этот метод» в правой части страницы.
  3. Настройте запрос:
    • Введите необходимые параметры запроса , такие как customerId , и разверните раздел Headers , чтобы указать необязательные HTTP-заголовки, такие как login-customer-id (требуется только при доступе к учетной записи через учетную запись менеджера). Обратите внимание, что токены разработчика ( developer-token ) были сняты с поддержки 9 сентября 2026 года и игнорируются серверами API, хотя вы все еще можете ввести значение, если форма запросит это.
    • Если метод требует ввода данных, например, для операций search или mutate , определите тело запроса с помощью интерактивного редактора JSON.
  4. Выполнить: Нажмите «Выполнить» , чтобы отправить запрос. Инструмент отобразит полный HTTP-запрос и JSON-ответ в реальном времени от API.

Основные характеристики

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

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

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