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

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

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

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

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