Google Drive

Operate Google Drive through your OOMOL-connected account. This skill calls the googledrive connector with the oo CLI; OOMOL injects credentials server-side, so you never handle raw tokens.

Category: Storage, Productivity. Exposes 66 action(s).

Running an action

Assume the user has already installed the oo CLI, signed in, and connected Google Drive. Do not run oo auth login or open the connection URL proactively — just run the action. Fall back to First-time setup only when a command actually fails with an auth or connection error.

1. Inspect the contract to get the authoritative input/output schema before building a payload:

oo connector schema "googledrive" --action "\x3Caction_name>"

2. Run the action with a JSON payload that matches the input schema:

oo connector run "googledrive" --action "\x3Caction_name>" --data '\x3Cjson>' --json

• --data takes a JSON object string or @path/to/file.json; omit it to send {}.
• The response is { "data": ..., "meta": { "executionId": "..." } }; the execution id lives under meta.executionId.

Each action below links to a reference file with its purpose and exact commands. Read the linked file, then fetch the live schema with oo connector schema before constructing --data.

Available actions

• copy_file — Legacy compatibility alias of copy_file_advanced with a simplified input shape.
• copy_file_advanced — Copy a Drive file and optionally override metadata such as name, parents, description, or properties.
• create_comment — Create a comment on a Drive file, optionally with anchor or quoted file content.
• create_drive — Create a new shared drive.
• create_file — Create a Google Drive file with metadata only. Use a Google Workspace mime type to create an empty native file shell.
• create_file_from_text — Create a new Drive file from text content and optional metadata.
• create_folder — Create a Google Drive folder, optionally under one or more parent folders.
• create_permission — Create a permission on a Drive file or shared drive to share it with users, groups, domains, or anyone.
• create_reply — Create a reply under an existing Drive file comment, or use an action payload such as resolve or reopen.
• create_team_drive — Legacy compatibility alias of create_drive for Team Drives.
• delete_comment — Permanently delete a comment thread from a Drive file.
• delete_drive — Permanently delete a shared drive.
• delete_file — Legacy compatibility alias for permanently deleting a Drive file by ID.
• delete_permission — Delete a permission from a Drive file or shared drive.
• delete_reply — Permanently delete a specific reply from a Drive file comment thread.
• delete_revision — Permanently delete a specific revision from a Drive file.
• delete_team_drive — Legacy compatibility alias of delete_drive for Team Drives.
• download_file — Download a Drive file by ID, or export a Google Workspace file when mimeType is provided. Returns a transit URL for the downloaded content.
• download_file_operation — Compatibility alias of download_file.
• download_file2 — Compatibility alias of download_file.
• edit_file — Overwrite an existing Drive file with text content and optional metadata changes.
• empty_trash — Permanently empty the user's trash or a shared drive's trash.
• export_google_workspace_file — Export a Google Workspace file to the requested MIME type and return a transit URL for the exported content.
• find_file — Search Google Drive files and folders with query, date, starred, trash, and shared-drive filters.
• find_folder — Search Google Drive folders only, with the same query and pagination controls as find_file.
• generate_ids — Generate one or more Drive file IDs for later create or copy requests.
• get_about — Get Drive account information such as user details, quota, and supported capabilities.
• get_app — Get metadata for a specific Google Drive app by app ID.
• get_changes_start_page_token — Get the page token for monitoring future Drive changes.
• get_comment — Get a specific comment on a Drive file by comment ID.
• get_drive — Get a shared drive by drive ID.
• get_file_metadata — Get metadata for a Drive file by ID, including mime type, parents, ownership, and trash state.
• get_permission — Get a specific permission on a Drive file or shared drive by permission ID.
• get_permission_id_for_email — Look up the Drive permission ID for an email address.
• get_reply — Get a specific reply under a Drive file comment.
• get_revision — Get metadata for a specific Drive file revision.
• get_team_drive — Legacy compatibility alias of get_drive for Team Drives.
• google_drive_delete_folder_or_file_action — Permanently delete a Drive file or folder by ID.
• hide_drive — Hide a shared drive from the default Drive view.
• list_access_proposals — List pending access proposals for a specific Drive file.
• list_approvals — List approvals associated with a specific Drive file.
• list_changes — List file and drive changes for incremental sync workflows.
• list_comments — List comments on a Drive file with pagination.
• list_file_labels — List the Drive labels currently applied to a file.
• list_permissions — List permissions on a Drive file or shared drive.
• list_replies — List replies under a Drive file comment with pagination.
• list_revisions — List revision metadata for a Drive file.
• list_shared_drives — List shared drives accessible to the connected account.
• list_team_drives — Legacy compatibility alias of list_shared_drives for Team Drives.
• modify_file_labels — Add, update, or remove Drive labels on a file.
• move_file — Move or rename a Drive file by updating parents and/or name.
• parse_file — Compatibility alias of download_file, including export behavior when mimeType is provided.
• patch_permission — Patch specific fields on an existing Drive permission.
• trash_file — Move a Drive file or folder to trash without permanently deleting it.
• unhide_drive — Unhide a shared drive and restore it to the default Drive view.
• untrash_file — Restore a Drive file or folder from trash.
• update_comment — Update the content of an existing Drive file comment.
• update_drive — Update metadata or restrictions on a shared drive.
• update_file_metadata_patch — Update Drive file metadata fields with patch semantics.
• update_file_put — Update a Drive file with metadata and optional uploaded content.
• update_file_revision_metadata — Update revision metadata flags such as publish or keep-forever on a specific Drive file revision.
• update_permission — Update an existing Drive permission using structured permission fields.
• update_reply — Update the content of an existing reply on a Drive file comment.
• update_team_drive — Legacy compatibility alias of update_drive for Team Drives.
• upload_file — Upload a new Drive file with binary or text content and optional metadata.
• upload_update_file — Replace the content of an existing Drive file and optionally update metadata.

Safety

• Read actions (get / list / search) are safe to run directly.
• Create, update, send, or post actions change Google Drive state — confirm the exact payload and effect with the user before running.
• Delete or remove actions are destructive — always confirm the target and get explicit approval first.

First-time setup

These are one-time steps — do not repeat them on every call. Run a step only when a command fails for the matching reason.

• oo: command not found — install the oo CLI (other platforms: \x3Chttps://cli.oomol.com/install-guide.md>):

  curl -fsSL https://cli.oomol.com/install.sh | bash    # macOS / Linux
  

  irm https://cli.oomol.com/install.ps1 | iex           # Windows PowerShell
  

• Not signed in / authentication error — sign in to your OOMOL account once:

  oo auth login
  

• scope_missing / credential_expired / app_not_ready / app_not_found — Google Drive is not connected, or the connection expired or lacks a scope. Connect once (auth type: OAuth2) at:

  https://console.oomol.com/app-connections?provider=googledrive
  

• HTTP 402 / OOMOL_INSUFFICIENT_CREDIT — billing stop. Recharge at https://console.oomol.com/billing/token-recharge before retrying.

Resources

• Google Drive homepage: https://workspace.google.com/products/drive/