Google Ads

Интеграция с Google Ads API с использованием управляемой OAuth-аутентификации. Этот инструмент позволяет выполнять запросы к кампаниям, группам объявлений, ключевым словам и метрикам эффективности через язык запросов GAQL.

Быстрый старт

Пример получения списка доступных аккаунтов Google Ads:

import urllib.request, os, json

req = urllib.request.Request(
 'https://gateway.maton.ai/google-ads/v23/customers:listAccessibleCustomers'
)
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')

print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Базовый URL

https://gateway.maton.ai/google-ads/{native-api-path}

Замените {native-api-path} на соответствующий путь эндпоинта Google Ads API. Запросы автоматически проксируются к googleads.googleapis.com с подстановкой OAuth и developer token.

Аутентификация

Каждый запрос должен содержать API-ключ Maton в заголовке:

Authorization: Bearer $MATON_API_KEY

Установите переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Получение API-ключа

• Войдите или зарегистрируйтесь на maton.ai
• Перейдите в раздел настроек
• Скопируйте ваш API-ключ

Управление подключениями

OAuth-подключения к Google Ads управляются через специальный сервис:

https://ctrl.maton.ai

Список подключений

import urllib.request, os, json

req = urllib.request.Request(
 'https://ctrl.maton.ai/connections?app=google-ads&status=ACTIVE'
)
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')

print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Создание подключения

import urllib.request, os, json

data = json.dumps({'app': 'google-ads'}).encode()

req = urllib.request.Request(
 'https://ctrl.maton.ai/connections',
 data=data,
 method='POST'
)

req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')

print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Получение информации о подключении

import urllib.request, os, json

req = urllib.request.Request(
 'https://ctrl.maton.ai/connections/{connection_id}'
)

req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')

print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

После создания подключения откройте URL из ответа в браузере, чтобы завершить OAuth-авторизацию.

Удаление подключения

import urllib.request, os, json

req = urllib.request.Request(
 'https://ctrl.maton.ai/connections/{connection_id}',
 method='DELETE'
)

req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')

print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Выбор подключения

Если у вас несколько подключений Google Ads, можно указать нужное через заголовок Maton-Connection:

import urllib.request, os, json

data = json.dumps({
 'query': 'SELECT campaign.id, campaign.name FROM campaign'
}).encode()

req = urllib.request.Request(
 'https://gateway.maton.ai/google-ads/v23/customers/1234567890/googleAds:search',
 data=data,
 method='POST'
)

req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
req.add_header('Maton-Connection', 'YOUR_CONNECTION_ID')

print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Если заголовок не указан, используется подключение по умолчанию (самое старое активное).

Назначение

Используйте этот инструмент, когда необходимо работать с данными Google Ads: получать статистику, анализировать кампании или автоматизировать управление рекламой. :