Google Docs

Google Docs — это интеграция с API Google Docs с управляемой OAuth-аутентификацией, позволяющая создавать документы, вставлять текст, применять форматирование и управлять содержимым документов.

Обзор

Данный инструмент предоставляет доступ к Google Docs через прокси-шлюз, автоматически обрабатывая авторизацию и упрощая работу с документами. Он подходит для сценариев, где необходимо программно создавать и редактировать документы без ручной настройки OAuth.

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

Пример получения документа через API:

import urllib.request, os, json

req = urllib.request.Request(
 'https://gateway.maton.ai/google-docs/v1/documents/{documentId}'
)
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-docs/{native-api-path}

Замените {native-api-path} на соответствующий путь API Google Docs. Шлюз автоматически перенаправляет запросы и добавляет OAuth-токен.

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

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

Authorization: Bearer $MATON_API_KEY

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

export MATON_API_KEY="YOUR_API_KEY"

Получить API-ключ можно в настройках аккаунта на maton.ai.

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

Для работы с Google Docs необходимо создать OAuth-подключение.

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

import urllib.request, os, json

req = urllib.request.Request(
 'https://ctrl.maton.ai/connections?app=google-docs&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-docs'}).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))

Пример ответа:

{
 "connection": {
 "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
 "status": "ACTIVE",
 "creation_time": "2025-12-08T07:20:53.488460Z",
 "last_updated_time": "2026-01-31T20:03:32.593153Z",
 "url": "https://connect.maton.ai/?session_token=...",
 "app": "google-docs",
 "metadata": {}
 }
}

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

Когда использовать

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