Google Drive

# List files
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/google-drive/drive/v3/files?pageSize=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

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

Authorization: Bearer $MATON_API_KEY

export MATON_API_KEY="YOUR_API_KEY"

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=google-drive&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'google-drive'}).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))
EOF

python <<'EOF'
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))
EOF

{
  "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-drive",
    "metadata": {}
  }
}

python <<'EOF'
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))
EOF

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/google-drive/drive/v3/files?pageSize=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

GET /google-drive/drive/v3/files?pageSize=10

GET /google-drive/drive/v3/files?q=name%20contains%20'report'&pageSize=10

GET /google-drive/drive/v3/files?q=mimeType='application/vnd.google-apps.folder'

GET /google-drive/drive/v3/files?q='FOLDER_ID'+in+parents

GET /google-drive/drive/v3/files?fields=files(id,name,mimeType,createdTime,modifiedTime,size)

GET /google-drive/drive/v3/files/{fileId}?fields=id,name,mimeType,size,createdTime

GET /google-drive/drive/v3/files/{fileId}?alt=media

GET /google-drive/drive/v3/files/{fileId}/export?mimeType=application/pdf

POST /google-drive/drive/v3/files
Content-Type: application/json

{
  "name": "New Document",
  "mimeType": "application/vnd.google-apps.document"
}

POST /google-drive/drive/v3/files
Content-Type: application/json

{
  "name": "New Folder",
  "mimeType": "application/vnd.google-apps.folder"
}

PATCH /google-drive/drive/v3/files/{fileId}
Content-Type: application/json

{
  "name": "Renamed File"
}

PATCH /google-drive/drive/v3/files/{fileId}?addParents=NEW_FOLDER_ID&removeParents=OLD_FOLDER_ID

DELETE /google-drive/drive/v3/files/{fileId}

POST /google-drive/drive/v3/files/{fileId}/copy
Content-Type: application/json

{
  "name": "Copy of File"
}

POST /google-drive/upload/drive/v3/files?uploadType=media
Content-Type: text/plain

<file content>

import urllib.request, os

file_content = b"Hello, this is file content!"

url = "https://gateway.maton.ai/google-drive/upload/drive/v3/files?uploadType=media"
req = urllib.request.Request(url, data=file_content, method="POST")
req.add_header("Authorization", f"Bearer {os.environ['MATON_API_KEY']}")
req.add_header("Content-Type", "text/plain")
response = urllib.request.urlopen(req)

POST /google-drive/upload/drive/v3/files?uploadType=multipart
Content-Type: multipart/related; boundary=boundary

--boundary
Content-Type: application/json; charset=UTF-8

{"name": "myfile.txt", "description": "My file"}
--boundary
Content-Type: text/plain

<file content>
--boundary--

import urllib.request, os, json

boundary = "----Boundary"
metadata = json.dumps({"name": "myfile.txt", "description": "My file"})
file_content = "File content here"

body = f"""--{boundary}\r
Content-Type: application/json; charset=UTF-8\r
\r
{metadata}\r
--{boundary}\r
Content-Type: text/plain\r
\r
{file_content}\r
--{boundary}--""".encode()

url = "https://gateway.maton.ai/google-drive/upload/drive/v3/files?uploadType=multipart"
req = urllib.request.Request(url, data=body, method="POST")
req.add_header("Authorization", f"Bearer {os.environ['MATON_API_KEY']}")
req.add_header("Content-Type", f"multipart/related; boundary={boundary}")
response = urllib.request.urlopen(req)

POST /google-drive/upload/drive/v3/files?uploadType=resumable
Content-Type: application/json; charset=UTF-8
X-Upload-Content-Type: application/octet-stream
X-Upload-Content-Length: <file_size>

{"name": "large_file.bin"}

PUT <upload_uri>
Content-Length: <file_size>
Content-Type: application/octet-stream

<file content>

import urllib.request, os, json

file_path = "/path/to/large_file.bin"
file_size = os.path.getsize(file_path)

# Step 1: Initiate resumable upload session
url = "https://gateway.maton.ai/google-drive/upload/drive/v3/files?uploadType=resumable"
metadata = json.dumps({"name": "large_file.bin"}).encode()

req = urllib.request.Request(url, data=metadata, method="POST")
req.add_header("Authorization", f"Bearer {os.environ['MATON_API_KEY']}")
req.add_header("Content-Type", "application/json; charset=UTF-8")
req.add_header("X-Upload-Content-Type", "application/octet-stream")
req.add_header("X-Upload-Content-Length", str(file_size))

response = urllib.request.urlopen(req)
upload_uri = response.headers["Location"]

# Step 2: Upload file in chunks (e.g., 5MB chunks)
chunk_size = 5 * 1024 * 1024
with open(file_path, "rb") as f:
    offset = 0
    while offset < file_size:
        chunk = f.read(chunk_size)
        end = offset + len(chunk) - 1

        req = urllib.request.Request(upload_uri, data=chunk, method="PUT")
        req.add_header("Content-Length", str(len(chunk)))
        req.add_header("Content-Range", f"bytes {offset}-{end}/{file_size}")

        response = urllib.request.urlopen(req)
        offset += len(chunk)

result = json.load(response)
print(f"Uploaded: {result['id']}")

req = urllib.request.Request(upload_uri, method="PUT")
req.add_header("Content-Length", "0")
req.add_header("Content-Range", "bytes */*")
response = urllib.request.urlopen(req)
# Check Range header in response to get current offset

PATCH /google-drive/upload/drive/v3/files/{fileId}?uploadType=media
Content-Type: text/plain

<new file content>

import urllib.request, os

file_id = "YOUR_FILE_ID"
new_content = b"Updated file content!"

url = f"https://gateway.maton.ai/google-drive/upload/drive/v3/files/{file_id}?uploadType=media"
req = urllib.request.Request(url, data=new_content, method="PATCH")
req.add_header("Authorization", f"Bearer {os.environ['MATON_API_KEY']}")
req.add_header("Content-Type", "text/plain")
response = urllib.request.urlopen(req)

metadata = json.dumps({"name": "myfile.txt", "parents": ["FOLDER_ID"]})

POST /google-drive/drive/v3/files/{fileId}/permissions
Content-Type: application/json

{
  "role": "reader",
  "type": "user",
  "emailAddress": "user@example.com"
}

name contains 'report' and mimeType = 'application/pdf'