From 2c0e002216dd6e35a884dbfca6a6c7baddc16b51 Mon Sep 17 00:00:00 2001 From: seang1121 Date: Tue, 10 Mar 2026 21:10:45 -0400 Subject: [PATCH 1/4] docs(drive): add supportsAllDrives note for shared drive access --- .changeset/drive-supportsAllDrives-docs.md | 5 +++++ skills/gws-drive/SKILL.md | 14 ++++++++++++++ 2 files changed, 19 insertions(+) create mode 100644 .changeset/drive-supportsAllDrives-docs.md diff --git a/.changeset/drive-supportsAllDrives-docs.md b/.changeset/drive-supportsAllDrives-docs.md new file mode 100644 index 00000000..5962c39c --- /dev/null +++ b/.changeset/drive-supportsAllDrives-docs.md @@ -0,0 +1,5 @@ +--- +"@googleworkspace/cli": patch +--- + +Add Shared Drives tip to gws-drive skill doc explaining supportsAllDrives usage diff --git a/skills/gws-drive/SKILL.md b/skills/gws-drive/SKILL.md index d22766b2..082dcd1c 100644 --- a/skills/gws-drive/SKILL.md +++ b/skills/gws-drive/SKILL.md @@ -135,3 +135,17 @@ gws schema drive.. Use `gws schema` output to build your `--params` and `--json` flags. +## Shared Drives + +Most `files` and `permissions` methods only search **My Drive** by default. +To include Shared Drive content, pass `supportsAllDrives: true` in `--params`: + +```bash +# list files in a shared drive +gws drive files list --params '{"driveId": "DRIVE_ID", "corpora": "drive", "supportsAllDrives": true, "includeItemsFromAllDrives": true}' + +# get a file that lives in a shared drive +gws drive files get --params '{"fileId": "FILE_ID", "supportsAllDrives": true}' +``` + +If a file or folder isn't found, add `supportsAllDrives: true` to the request. From d8ff11132bea0d9d32aa478c3aa0d71116dbc455 Mon Sep 17 00:00:00 2001 From: seang1121 Date: Wed, 11 Mar 2026 00:40:08 -0400 Subject: [PATCH 2/4] docs(gws-drive): remove deprecated corpora param from shared drive example --- 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 082dcd1c..0410743b 100644 --- a/skills/gws-drive/SKILL.md +++ b/skills/gws-drive/SKILL.md @@ -142,7 +142,7 @@ To include Shared Drive content, pass `supportsAllDrives: true` in `--params`: ```bash # list files in a shared drive -gws drive files list --params '{"driveId": "DRIVE_ID", "corpora": "drive", "supportsAllDrives": true, "includeItemsFromAllDrives": true}' +gws drive files list --params '{"driveId": "DRIVE_ID", "supportsAllDrives": true, "includeItemsFromAllDrives": true}' # get a file that lives in a shared drive gws drive files get --params '{"fileId": "FILE_ID", "supportsAllDrives": true}' From 14ace7551b138872e82a325bc5ab7721227521b1 Mon Sep 17 00:00:00 2001 From: seang1121 Date: Wed, 11 Mar 2026 00:54:49 -0400 Subject: [PATCH 3/4] docs(gws-drive): restore corpora param required by Drive API when driveId is set --- 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 0410743b..323f809a 100644 --- a/skills/gws-drive/SKILL.md +++ b/skills/gws-drive/SKILL.md @@ -142,7 +142,7 @@ To include Shared Drive content, pass `supportsAllDrives: true` in `--params`: ```bash # list files in a shared drive -gws drive files list --params '{"driveId": "DRIVE_ID", "supportsAllDrives": true, "includeItemsFromAllDrives": true}' +gws drive files list --params '{"corpora": "drive", "driveId": "DRIVE_ID", "supportsAllDrives": true, "includeItemsFromAllDrives": true}' # get a file that lives in a shared drive gws drive files get --params '{"fileId": "FILE_ID", "supportsAllDrives": true}' From e1e350ccec5c6677af055624b801f1befcc82548 Mon Sep 17 00:00:00 2001 From: seang1121 Date: Wed, 11 Mar 2026 01:07:46 -0400 Subject: [PATCH 4/4] docs(gws-drive): clarify shared drive tip to list all required params --- 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 323f809a..36e583b8 100644 --- a/skills/gws-drive/SKILL.md +++ b/skills/gws-drive/SKILL.md @@ -148,4 +148,4 @@ gws drive files list --params '{"corpora": "drive", "driveId": "DRIVE_ID", "supp gws drive files get --params '{"fileId": "FILE_ID", "supportsAllDrives": true}' ``` -If a file or folder isn't found, add `supportsAllDrives: true` to the request. +If a file or folder isn't found, ensure your request includes all necessary parameters for Shared Drive access (e.g., `supportsAllDrives: true`, `includeItemsFromAllDrives: true`).