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. Найдите панель Try this method (Попробовать этот метод) в правой части страницы.
  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.