Google Drive

Connect to Google Drive. Manage files, folders, and sharing permissions

Supports authentication: OAuth 2.0

Usage

Connect a user’s Google Drive account and make API calls on their behalf — Scalekit handles OAuth and token management automatically.

You can interact with Google Drive in two ways — via direct proxy API calls or via Scalekit optimized tool calls. Scroll down to see the list of available Scalekit tools.

1
import { ScalekitClient } from '@scalekit-sdk/node';
2
import 'dotenv/config';
3

4
const connectionName = 'google_drive'; // get your connection name from connection configurations
5
const identifier = 'user_123';         // your unique user identifier
6

7
// Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
8
const scalekit = new ScalekitClient(
9
  process.env.SCALEKIT_ENV_URL,
10
  process.env.SCALEKIT_CLIENT_ID,
11
  process.env.SCALEKIT_CLIENT_SECRET
12
);
13
const actions = scalekit.actions;
14

15
// Authenticate the user
16
const { link } = await actions.getAuthorizationLink({
17
  connectionName,
18
  identifier,
19
});
20
console.log('🔗 Authorize Google Drive:', link); // present this link to your user for authorization, or click it yourself for testing
21
process.stdout.write('Press Enter after authorizing...');
22
await new Promise(r => process.stdin.once('data', r));
23

24
// Make a request via Scalekit proxy
25
const result = await actions.request({
26
  connectionName,
27
  identifier,
28
  path: '/drive/v3/files',
29
  method: 'GET',
30
});
31
console.log(result);

1
import scalekit.client, os
2
from dotenv import load_dotenv
3
load_dotenv()
4

5
connection_name = "google_drive"  # get your connection name from connection configurations
6
identifier = "user_123"           # your unique user identifier
7

8
# Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
9
scalekit_client = scalekit.client.ScalekitClient(
10
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
11
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
12
    env_url=os.getenv("SCALEKIT_ENV_URL"),
13
)
14
actions = scalekit_client.actions
15

16
# Authenticate the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier
20
)
21
# present this link to your user for authorization, or click it yourself for testing
22
print("🔗 Authorize Google Drive:", link_response.link)
23
input("Press Enter after authorizing...")
24

25
# Make a request via Scalekit proxy
26
result = actions.request(
27
    connection_name=connection_name,
28
    identifier=identifier,
29
    path="/drive/v3/files",
30
    method="GET"
31
)
32
print(result)

Scalekit Tools

File operations

Download a file

Download a file from Google Drive by its file ID via the Scalekit proxy.

Python

1
import scalekit.client, os
2
from dotenv import load_dotenv
3
load_dotenv()
4

5
connection_name = "google_drive"  # get your connection name from connection configurations
6
identifier = "user_123"           # your unique user identifier
7

8
scalekit_client = scalekit.client.ScalekitClient(
9
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
10
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
11
    env_url=os.getenv("SCALEKIT_ENV_URL"),
12
)
13

14
file_id = "<YOUR_FILE_ID>"   # file ID from Drive (visible in the file's URL)
15
output_path = "downloaded.pdf"
16

17
response = scalekit_client.actions.request(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
    path=f"/drive/v3/files/{file_id}",
21
    method="GET",
22
    query_params={"alt": "media"},
23
)
24

25
with open(output_path, "wb") as f:
26
    f.write(response.content)
27

28
print(f"Downloaded: {output_path} ({len(response.content):,} bytes)")

Upload a file

Upload a file to Google Drive via the Scalekit proxy. Scalekit injects the OAuth token automatically — your app never handles credentials directly.

Python

1
import mimetypes
2
import scalekit.client, os
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
connection_name = "google_drive"  # get your connection name from connection configurations
7
identifier = "user_123"           # your unique user identifier
8

9
scalekit_client = scalekit.client.ScalekitClient(
10
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
11
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
12
    env_url=os.getenv("SCALEKIT_ENV_URL"),
13
)
14

15
file_path = "report.pdf"
16
file_name = "report.pdf"
17

18
with open(file_path, "rb") as f:
19
    file_bytes = f.read()
20

21
mime_type = mimetypes.guess_type(file_path)[0] or "application/octet-stream"
22

23
response = scalekit_client.actions.request(
24
    connection_name=connection_name,
25
    identifier=identifier,
26
    path="/upload/drive/v3/files",
27
    method="POST",
28
    query_params={"uploadType": "media", "name": file_name},
29
    form_data=file_bytes,
30
    headers={"Content-Type": mime_type},
31
)
32

33
file_id = response.json()["id"]
34
print(f"Uploaded: {file_name} (File ID: {file_id})")

`googledrive_get_file_metadata`

Retrieve metadata for a specific file in Google Drive by its file ID. Returns name, MIME type, size, creation time, and more.

Name	Type	Required	Description
`fields`	string	No	Fields to include in the response
`file_id`	string	Yes	The ID of the file to retrieve metadata for
`schema_version`	string	No	Optional schema version to use for tool execution
`supports_all_drives`	boolean	No	Support shared drives
`tool_version`	string	No	Optional tool version to use for execution

`googledrive_search_content`

Search inside the content of files stored in Google Drive using full-text search. Finds files where the body text matches the search term.

Name	Type	Required	Description
`fields`	string	No	Fields to include in the response
`mime_type`	string	No	Filter results by MIME type
`page_size`	integer	No	Number of files to return per page
`page_token`	string	No	Token for the next page of results
`schema_version`	string	No	Optional schema version to use for tool execution
`search_term`	string	Yes	Text to search for inside file contents
`supports_all_drives`	boolean	No	Include shared drives in results
`tool_version`	string	No	Optional tool version to use for execution

`googledrive_search_files`

Search for files and folders in Google Drive using query filters like name, type, owner, and parent folder.

Name	Type	Required	Description
`fields`	string	No	Fields to include in the response
`order_by`	string	No	Sort order for results
`page_size`	integer	No	Number of files to return per page
`page_token`	string	No	Token for the next page of results
`query`	string	No	Drive search query string
`schema_version`	string	No	Optional schema version to use for tool execution
`supports_all_drives`	boolean	No	Include shared drives in results
`tool_version`	string	No	Optional tool version to use for execution

Tool list