From 607999014155ab6ca7e13ff5ea407c75f6e9425a Mon Sep 17 00:00:00 2001 From: Varun Nuthalapati Date: Sun, 12 Apr 2026 10:17:20 -0700 Subject: [PATCH 1/4] docs(drive): add shared drives tip to SKILL.md Files in shared drives are not returned by default. Adds a 'Shared Drives' section with supportsAllDrives examples and a tip for agents to retry with the flag when a file cannot be found. --- .changeset/docs-drive-shared-drives-tip.md | 11 +++++++++++ skills/gws-drive/SKILL.md | 14 ++++++++++++++ 2 files changed, 25 insertions(+) create mode 100644 .changeset/docs-drive-shared-drives-tip.md diff --git a/.changeset/docs-drive-shared-drives-tip.md b/.changeset/docs-drive-shared-drives-tip.md new file mode 100644 index 00000000..b8e9ed7c --- /dev/null +++ b/.changeset/docs-drive-shared-drives-tip.md @@ -0,0 +1,11 @@ +--- +"@googleworkspace/cli": patch +--- + +docs(drive): add shared drives tip to SKILL.md + +Files in shared drives are invisible to `files list` and `files get` +by default. Adds a "Shared Drives" section explaining that agents +should retry with `supportsAllDrives: true` and +`includeItemsFromAllDrives: true` when a file search returns no +results and the user indicates the file is in a shared drive. diff --git a/skills/gws-drive/SKILL.md b/skills/gws-drive/SKILL.md index d4debbdb..ea5666a0 100644 --- a/skills/gws-drive/SKILL.md +++ b/skills/gws-drive/SKILL.md @@ -25,6 +25,20 @@ gws drive [flags] |---------|-------------| | [`+upload`](../gws-drive-upload/SKILL.md) | Upload a file with automatic metadata | +## Shared Drives + +Files stored in a shared drive are not returned by default. If a file search returns no results, add `supportsAllDrives=true` to your `--params`: + +```bash +# List files across all drives (including shared drives) +gws drive files list --params '{"q":"name = '\''report.pdf'\''","supportsAllDrives":true,"includeItemsFromAllDrives":true}' + +# Get a file that lives in a shared drive +gws drive files get --params '{"fileId":"FILE_ID","supportsAllDrives":true}' +``` + +> **Tip:** If you can't find a file and the user mentions it's in a shared drive, retry the request with `supportsAllDrives: true` and `includeItemsFromAllDrives: true`. + ## API Resources ### about From ff2829d8352034cabb8e048d282ab9d2f6e80e92 Mon Sep 17 00:00:00 2001 From: nuthalapativarun Date: Sun, 12 Apr 2026 10:46:29 -0700 Subject: [PATCH 2/4] Update skills/gws-drive/SKILL.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- skills/gws-drive/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/gws-drive/SKILL.md b/skills/gws-drive/SKILL.md index ea5666a0..e763e706 100644 --- a/skills/gws-drive/SKILL.md +++ b/skills/gws-drive/SKILL.md @@ -37,7 +37,7 @@ gws drive files list --params '{"q":"name = '\''report.pdf'\''","supportsAllDriv gws drive files get --params '{"fileId":"FILE_ID","supportsAllDrives":true}' ``` -> **Tip:** If you can't find a file and the user mentions it's in a shared drive, retry the request with `supportsAllDrives: true` and `includeItemsFromAllDrives: true`. +> **Tip:** If you can't find a file and the user mentions it's in a shared drive, retry the request with "supportsAllDrives": true (and "includeItemsFromAllDrives": true for list requests). ## API Resources From 75313e25698a47eb9c3874e5bc8b951030cb3982 Mon Sep 17 00:00:00 2001 From: nuthalapativarun Date: Sun, 12 Apr 2026 10:46:38 -0700 Subject: [PATCH 3/4] Update skills/gws-drive/SKILL.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- skills/gws-drive/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/gws-drive/SKILL.md b/skills/gws-drive/SKILL.md index e763e706..7fdd14c7 100644 --- a/skills/gws-drive/SKILL.md +++ b/skills/gws-drive/SKILL.md @@ -27,7 +27,7 @@ gws drive [flags] ## Shared Drives -Files stored in a shared drive are not returned by default. If a file search returns no results, add `supportsAllDrives=true` to your `--params`: +Files stored in a shared drive are not returned by default. If a file search returns no results, add "supportsAllDrives": true to your --params: ```bash # List files across all drives (including shared drives) From 2a0144f8710449c428cd37f0b020f8ab90ec029f Mon Sep 17 00:00:00 2001 From: Varun Nuthalapati Date: Sun, 12 Apr 2026 10:56:27 -0700 Subject: [PATCH 4/4] fix(drive): use JSON syntax for supportsAllDrives; clarify includeItemsFromAllDrives scope - Intro text used URL-param style (supportsAllDrives=true); change to JSON object style ("supportsAllDrives": true) to match --params format - includeItemsFromAllDrives is only valid for files.list, not files.get; note this in the tip to prevent parameter errors on get requests --- skills/gws-drive/SKILL.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/gws-drive/SKILL.md b/skills/gws-drive/SKILL.md index 7fdd14c7..588f7b8c 100644 --- a/skills/gws-drive/SKILL.md +++ b/skills/gws-drive/SKILL.md @@ -27,7 +27,7 @@ gws drive [flags] ## Shared Drives -Files stored in a shared drive are not returned by default. If a file search returns no results, add "supportsAllDrives": true to your --params: +Files stored in a shared drive are not returned by default. If a file search returns no results, add `"supportsAllDrives": true` to your `--params`: ```bash # List files across all drives (including shared drives) @@ -37,7 +37,7 @@ gws drive files list --params '{"q":"name = '\''report.pdf'\''","supportsAllDriv gws drive files get --params '{"fileId":"FILE_ID","supportsAllDrives":true}' ``` -> **Tip:** If you can't find a file and the user mentions it's in a shared drive, retry the request with "supportsAllDrives": true (and "includeItemsFromAllDrives": true for list requests). +> **Tip:** If you can't find a file and the user mentions it's in a shared drive, retry the request with `"supportsAllDrives": true` (and `"includeItemsFromAllDrives": true` for list/search requests only — this parameter is not valid for `files.get`). ## API Resources