Update Google Drive docs with GetFileTreeStructure tool (#182)

* document GetFileTreeStructure tool

* examples for getting Drive file tree structure

Author: byrro

pages/toolkits/productivity/google/drive.mdx

@@ -80,6 +80,42 @@ List documents in the user's Google Drive. Excludes documents that are in the tr
 - **`supports_all_drives`** _(bool, optional)_ Whether the requesting application supports both My Drives and shared drives. Defaults to `False`.
 - **`limit`** _(int, optional)_ The number of documents to list. Defaults to `50`.
 
+## GetFileTreeStructure
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool with User Authorization",
+      content: {
+        Python: [
+          "/examples/integrations/toolkits/google/drive/get_file_tree_structure_example_call_tool.py",
+        ],
+        JavaScript: ["/examples/integrations/toolkits/google/drive/get_file_tree_structure_example_call_tool.js"],
+      },
+    },
+    {
+      label: "Execute the Tool with OpenAI",
+      content: {
+        Python: [
+          "/examples/integrations/toolkits/google/drive/get_file_tree_structure_example_llm_oai.py",
+        ],
+        JavaScript: ["/examples/integrations/toolkits/google/drive/get_file_tree_structure_example_llm_oai.js"],
+      },
+    },
+  ]}
+/>
+
+Get the file/folder tree structure of the user's Google Drive.
+
+**Parameters**
+
+- **`include_shared_drives`** _(bool, optional)_ Whether to include shared drives in the file tree structure. Defaults to False.
+- **`restrict_to_shared_drive_id`** _(str, optional)_ If provided, only include files from this shared drive in the file tree structure. Defaults to None, which will include files and folders from all drives.
+- **`include_organization_domain_documents`** _(bool, optional)_ Whether to include documents from the organization's domain. This is applicable to admin users who have permissions to view organization-wide documents in a Google Workspace account. Defaults to False.
+- **`order_by`** _(enum ([OrderBy](/toolkits/productivity/google/reference#orderby)), optional)_ Sort order. Defaults to listing the most recently modified documents first.
+- **`limit`** _(int, optional)_ The number of files and folders to list. Defaults to None, which will list all files and folders.
+
 ## Auth
 
 The Arcade Drive toolkit uses the [Google auth provider](/home/auth-providers/google) to connect to users' Google accounts.

public/examples/integrations/toolkits/google/drive/get_file_tree_structure_example_call_tool.js

@@ -0,0 +1,32 @@
+import { Arcade } from "@arcadeai/arcadejs";
+
+const client = new Arcade(); // Automatically finds the `ARCADE_API_KEY` env variable
+
+const USER_ID = "[email protected]";
+const TOOL_NAME = "Google.GetFileTreeStructure";
+
+// Start the authorization process
+const authResponse = await client.tools.authorize({
+  tool_name: TOOL_NAME,
+  user_id: USER_ID,
+});
+
+if (authResponse.status !== "completed") {
+  console.log(`Click this link to authorize: ${authResponse.url}`);
+}
+
+// Wait for the authorization to complete
+await client.auth.waitForCompletion(authResponse);
+
+const toolInput = {
+  include_shared_drives: true,
+  limit: 10,
+};
+
+const response = await client.tools.execute({
+  tool_name: TOOL_NAME,
+  input: toolInput,
+  user_id: USER_ID,
+});
+
+console.log(response);

public/examples/integrations/toolkits/google/drive/get_file_tree_structure_example_call_tool.py

@@ -0,0 +1,29 @@
+from arcadepy import Arcade
+
+client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
+
+USER_ID = "[email protected]"
+TOOL_NAME = "Google.GetFileTreeStructure"
+
+auth_response = client.tools.authorize(
+    tool_name=TOOL_NAME,
+    user_id=USER_ID,
+)
+
+if auth_response.status != "completed":
+    print(f"Click this link to authorize: {auth_response.url}")
+
+# Wait for the authorization to complete
+client.auth.wait_for_completion(auth_response)
+
+tool_input = {
+    "include_shared_drives": True,
+    "limit": 10,
+}
+
+response = client.tools.execute(
+    tool_name=TOOL_NAME,
+    input=tool_input,
+    user_id=USER_ID,
+)
+print(response)

public/examples/integrations/toolkits/google/drive/get_file_tree_structure_example_llm_oai.js

@@ -0,0 +1,22 @@
+import OpenAI from 'openai';
+
+const USER_ID = "[email protected]";
+const PROMPT = "Get a file tree structure of my Google Drive, including shared drives.";
+const TOOL_NAME = "Google.GetFileTreeStructure";
+
+const client = new OpenAI({
+  baseURL: 'https://api.arcade.dev',
+  apiKey: process.env.ARCADE_API_KEY
+});
+
+const response = await client.chat.completions.create({
+  messages: [
+    { role: 'user', content: PROMPT }
+  ],
+  model: 'gpt-4o-mini',
+  user: USER_ID,
+  tools: [TOOL_NAME],
+  tool_choice: 'generate'
+});
+
+console.log(response.choices[0].message.content);

public/examples/integrations/toolkits/google/drive/get_file_tree_structure_example_llm_oai.py

@@ -0,0 +1,21 @@
+import os
+from openai import OpenAI
+
+USER_ID = "[email protected]"
+PROMPT = "Get a file tree structure of my Google Drive, including shared drives."
+TOOL_NAME = "Google.GetFileTreeStructure"
+
+client = OpenAI(
+    base_url="https://api.arcade.dev", api_key=os.environ.get("ARCADE_API_KEY")
+)
+
+response = client.chat.completions.create(
+    messages=[
+        {"role": "user", "content": PROMPT},
+    ],
+    model="gpt-4o-mini",
+    user=USER_ID,
+    tools=[TOOL_NAME],
+    tool_choice="generate",
+)
+print(response.choices[0].message.content)