Google Analytics

Google Analytics

Получите доступ к Google Analytics с управляемой OAuth-аутентификацией. Данный инструмент охватывает как Admin API (для управления аккаунтами, ресурсами и потоками данных), так и Data API (для построения отчетов по метрикам).

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

# Получить сводку аккаунтов (Admin API)
curl -s -X GET "https://gateway.maton.ai/google-analytics-admin/v1beta/accountSummaries" \
-H "Authorization: Bearer $MATON_API_KEY"

# Запустить отчет (Data API)
curl -s -X POST "https://gateway.maton.ai/google-analytics-data/v1beta/properties/{propertyId}:runReport" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MATON_API_KEY" \
-d '{
 "dateRanges": [{"startDate": "30daysAgo", "endDate": "today"}],
 "dimensions": [{"name": "city"}],
 "metrics": [{"name": "activeUsers"}]
}'

Базовые URL

Admin API (управление аккаунтами, ресурсами и потоками данных):

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

Data API (построение отчетов):

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

Замените {native-api-path} на фактический путь API Google Analytics. Шлюз проксирует запросы к analyticsadmin.googleapis.com и analyticsdata.googleapis.com, автоматически добавляя OAuth-токен.

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

Все запросы требуют API-ключ Maton в заголовке Authorization:

Authorization: Bearer $MATON_API_KEY

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

export MATON_API_KEY="YOUR_API_KEY"

Как получить API-ключ

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

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

Управляйте OAuth-подключениями Google через интерфейс: https://ctrl.maton.ai.

Важно: Admin API и Data API используют разные подключения:

• google-analytics-admin — для Admin API (управление аккаунтами, ресурсами и потоками)
• google-analytics-data — для Data API (формирование отчетов)

Создайте нужное подключение в зависимости от сценария использования.

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

# Список подключений Admin API
curl -s -X GET "https://ctrl.maton.ai/connections?app=google-analytics-admin&status=ACTIVE" \
-H "Authorization: Bearer $MATON_API_KEY"

# Список подключений Data API
curl -s -X GET "https://ctrl.maton.ai/connections?app=google-analytics-data&status=ACTIVE" \
-H "Authorization: Bearer $MATON_API_KEY"

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

# Создать подключение для Admin API
curl -s -X POST "https://ctrl.maton.ai/connections" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MATON_API_KEY" \
-d '{"app": "google-analytics-admin"}'

# Создать подключение для Data API
curl -s -X POST "https://ctrl.maton.ai/connections" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MATON_API_KEY" \
-d '{"app": "google-analytics-data"}'

Получить подключение

curl -s -X GET "https://ctrl.maton.ai/connections/{connection_id}" \
-H "Authorization: Bearer $MATON_API_KEY"

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

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

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

Maton-Connection: {connection_id}

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

Справочник Admin API

Аккаунты

GET /google-analytics-admin/v1beta/accounts
GET /google-analytics-admin/v1beta/accounts/{accountId}
GET /google-analytics-admin/v1beta/accountSummaries

Ресурсы (Properties)

GET /google-analytics-admin/v1beta/properties?filter=parent:accounts/{accountId}
GET /google-analytics-admin/v1beta/properties/{propertyId}

Создание ресурса

POST /google-analytics-admin/v1beta/properties
Content-Type: application/json

{
 "parent": "accounts/{accountId}",
 "displayName": "My New Property",
 "timeZone": "America/Los_Angeles",
 "currencyCode": "USD"
}

Потоки данных

GET /google-analytics-admin/v1beta/properties/{propertyId}/dataStreams