> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Drive

> Manage files, folders, shared drives, permissions, comments, and revisions in Google Drive

# Google Drive

Shanone's Google Drive integration gives your agent 50 tools for files, folders, shared drives, permissions, comments, and revision history — covering everything from a quick upload to auditing who has access to a document.

## Getting Started

<Steps>
  <Step title="Connect via OAuth">
    Ask your agent to do something with Drive (e.g. "list the files in my Shared Reports folder"), or connect proactively from **Integrations** in the Shanone dashboard.
  </Step>

  <Step title="Authorize the Google account">
    Approve Google's OAuth consent screen for the account whose Drive Shanone should access.
  </Step>

  <Step title="Retry your request">
    Once connected, `shanone_execute_tool` calls for `google_drive_*` tools will succeed.
  </Step>
</Steps>

## Available Tools

Shanone provides **50 tools** for Google Drive, organized into these categories:

<AccordionGroup>
  <Accordion title="Files">
    `google_drive_about`, `google_drive_list_files`, `google_drive_search`, `google_drive_get_file`, `google_drive_download_file`, `google_drive_export_file`, `google_drive_upload_file`, `google_drive_create_file_from_text`, `google_drive_create_folder`, `google_drive_update_file`, `google_drive_copy_file`, `google_drive_delete_file`, `google_drive_trash_file`, `google_drive_untrash_file`, `google_drive_empty_trash`
  </Accordion>

  <Accordion title="Drives, labels & shortcuts">
    `google_drive_list_drives`, `google_drive_get_drive`, `google_drive_create_drive`, `google_drive_update_drive`, `google_drive_hide_drive`, `google_drive_unhide_drive`, `google_drive_delete_drive`, `google_drive_list_labels`, `google_drive_modify_labels`, `google_drive_generate_ids`, `google_drive_move_file`, `google_drive_create_shortcut`
  </Accordion>

  <Accordion title="Sharing & permissions">
    `google_drive_list_permissions`, `google_drive_get_permission`, `google_drive_create_permission`, `google_drive_update_permission`, `google_drive_delete_permission`
  </Accordion>

  <Accordion title="Comments & replies">
    `google_drive_list_comments`, `google_drive_get_comment`, `google_drive_create_comment`, `google_drive_update_comment`, `google_drive_delete_comment`, `google_drive_list_replies`, `google_drive_get_reply`, `google_drive_create_reply`, `google_drive_update_reply`, `google_drive_delete_reply`
  </Accordion>

  <Accordion title="Revisions & change tracking">
    `google_drive_list_revisions`, `google_drive_get_revision`, `google_drive_update_revision`, `google_drive_delete_revision`, `google_drive_get_start_page_token`, `google_drive_list_changes`, `google_drive_watch_changes`, `google_drive_stop_channel`
  </Accordion>
</AccordionGroup>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Document triage" icon="folder-search">
    Search a Shared Drive for recent files matching a topic and summarize them
  </Card>

  <Card title="Access audits" icon="shield-check">
    List permissions on a sensitive file or folder and flag anyone who shouldn't have access
  </Card>

  <Card title="Bulk organization" icon="folder-tree">
    Move, copy, or re-label a batch of files into the right folder structure
  </Card>

  <Card title="Review threads" icon="message-square-text">
    Read and reply to comment threads on a document without opening the browser
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="google_drive_get_file returns a 404 for a file I can see in the browser">
    The file ID is likely wrong — copy it from the Drive URL (the long string between `/d/` and the next `/`) rather than typing it manually, and confirm the connected account actually has access to that file.
  </Accordion>

  <Accordion title="google_drive_download_file fails on a Google Doc/Sheet/Slide">
    Native Google Workspace files (Docs, Sheets, Slides) aren't downloadable as raw bytes — use `google_drive_export_file` instead, which converts them to a format like PDF or DOCX first.
  </Accordion>

  <Accordion title="google_drive_watch_changes notifications aren't arriving">
    Push notifications require a publicly reachable HTTPS webhook URL configured as the channel address; this is a project-level setup step outside Shanone. Use `google_drive_list_changes` for polling instead if you don't need push notifications.
  </Accordion>

  <Accordion title="Permission changes don't seem to take effect">
    Check the `role` and `type` fields sent to `google_drive_create_permission` — Drive's permission model distinguishes `user`, `group`, `domain`, and `anyone`, and each has a different set of valid roles.
  </Accordion>
</AccordionGroup>