Add GoogleDocs tools

Author: EricGustin

pages/toolkits/productivity/google_docs.mdx

@@ -38,6 +38,8 @@ These tools are currently available in the Arcade Google Docs toolkit.
     ["GoogleDocs.CreateDocumentFromText", "Create a new Google Docs document with specified text content. Note: This tool currently requires a self-hosted instance of Arcade.", ],
     ["GoogleDocs.SearchDocuments", "Search for documents in the user's Google Drive. Note: This tool currently requires a self-hosted instance of Arcade."],
     ["GoogleDocs.SearchAndRetrieveDocuments", "Search and retrieve the contents of Google documents in the user's Google Drive. Note: This tool currently requires a self-hosted instance of Arcade."],
+    ["GoogleDocs.ListDocumentComments", "List all comments on the specified Google Docs document. Note: This tool currently requires a self-hosted instance of Arcade.", ],
+    ["GoogleDocs.CommentOnDocument", "Comment on a specific document by its ID. Note: This tool currently requires a self-hosted instance of Arcade.", ],
   ]}
 />
 
@@ -211,6 +213,60 @@ Searches for documents in the user's Google Drive and returns a list of document
 - **`limit`** _(int, optional)_ The number of documents to list. Defaults to `50`.
 - **`pagination_token`** _(str, optional)_ The pagination token to continue a previous request
 
+---
+
+## GoogleDocs.ListDocumentComments
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool with User Authorization",
+      content: {
+        Python: [
+          "/examples/integrations/toolkits/google/docs/list_document_comments.py",
+        ],
+        JavaScript: ["/examples/integrations/toolkits/google/docs/list_document_comments.js"],
+      },
+    }
+  ]}
+/>
+
+List all comments on the specified Google Docs document.
+
+**Parameters**
+
+- **`document_id`** _(string, required)_ The ID of the document to list comments for.
+- **`include_deleted`** _(bool, optional)_ Whether to include deleted comments in the results. Defaults to False.
+
+---
+
+## GoogleDocs.CommentOnDocument
+
+<br />
+<TabbedCodeBlock
+  tabs={[
+    {
+      label: "Call the Tool with User Authorization",
+      content: {
+        Python: [
+          "/examples/integrations/toolkits/google/docs/comment_on_document.py",
+        ],
+        JavaScript: ["/examples/integrations/toolkits/google/docs/comment_on_document.js"],
+      },
+    }
+  ]}
+/>
+
+Comment on a specific document by its ID.
+
+**Parameters**
+
+- **`document_id`** _(string, required)_ The ID of the document to comment on.
+- **`comment_text`** _(string, required)_ The comment to add to the document.
+
+
+---
 ## Auth
 
 The Arcade Docs toolkit uses the [Google auth provider](/home/auth-providers/google) to connect to users' Google accounts.

public/examples/integrations/toolkits/google/docs/comment_on_document.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 = "{arcade_user_id}";
+const TOOL_NAME = "GoogleDocs.CommentOnDocument";
+
+// 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 = {
+  document_id: "your_document_id_here",
+  comment_text: "This is a comment"
+};
+
+const response = await client.tools.execute({
+  tool_name: TOOL_NAME,
+  input: toolInput,
+  user_id: USER_ID,
+});
+
+console.log(response);

public/examples/integrations/toolkits/google/docs/comment_on_document.py

@@ -0,0 +1,26 @@
+from arcadepy import Arcade
+
+client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
+
+USER_ID = "{arcade_user_id}"
+TOOL_NAME = "GoogleDocs.CommentOnDocument"
+
+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 = {"document_id": "your_document_id_here", "comment_text": "This is a comment"}
+
+response = client.tools.execute(
+    tool_name=TOOL_NAME,
+    input=tool_input,
+    user_id=USER_ID,
+)
+print(response)

public/examples/integrations/toolkits/google/docs/list_document_comments.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 = "{arcade_user_id}";
+const TOOL_NAME = "GoogleDocs.ListDocumentComments";
+
+// 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 = {
+  document_id: "your_document_id_here",
+  include_deleted: false
+};
+
+const response = await client.tools.execute({
+  tool_name: TOOL_NAME,
+  input: toolInput,
+  user_id: USER_ID,
+});
+
+console.log(response);

public/examples/integrations/toolkits/google/docs/list_document_comments.py

@@ -0,0 +1,26 @@
+from arcadepy import Arcade
+
+client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
+
+USER_ID = "{arcade_user_id}"
+TOOL_NAME = "GoogleDocs.ListDocumentComments"
+
+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 = {"document_id": "your_document_id_here", "include_deleted": False}
+
+response = client.tools.execute(
+    tool_name=TOOL_NAME,
+    input=tool_input,
+    user_id=USER_ID,
+)
+print(response)