Skip to content

docs(drive): add shared drives tip to SKILL.md#711

Open
nuthalapativarun wants to merge 4 commits intogoogleworkspace:mainfrom
nuthalapativarun:docs/drive-shared-drives-tip
Open

docs(drive): add shared drives tip to SKILL.md#711
nuthalapativarun wants to merge 4 commits intogoogleworkspace:mainfrom
nuthalapativarun:docs/drive-shared-drives-tip

Conversation

@nuthalapativarun
Copy link
Copy Markdown

Summary

Closes #327

Files stored in a shared drive are invisible to files list and files get by default. Agents searching for a file have no indication that they should retry with supportsAllDrives: true, causing unnecessary back-and-forth with the user.

This PR adds a Shared Drives section to skills/gws-drive/SKILL.md that:

  • Explains the default behaviour (shared drive files excluded)
  • Shows concrete examples with supportsAllDrives: true and includeItemsFromAllDrives: true
  • Adds a tip so agents know to retry automatically when the user mentions a shared drive

Changes

  • skills/gws-drive/SKILL.md — new "Shared Drives" section with examples
  • .changeset/docs-drive-shared-drives-tip.md — patch changeset

@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Apr 12, 2026

🦋 Changeset detected

Latest commit: 2a0144f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@googleworkspace/cli Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request improves the usability of the Google Workspace CLI by enhancing documentation for shared drive operations and simplifying access to the Admin SDK Directory API. By adding clear examples for shared drive parameters and creating intuitive aliases for the Directory service, the changes reduce friction for users and agents interacting with these APIs.

Highlights

  • Documentation Update: Added a new 'Shared Drives' section to the Google Drive skill documentation, providing guidance on using supportsAllDrives and includeItemsFromAllDrives parameters.
  • Service Aliasing: Introduced 'admin-directory' and 'directory' aliases for the Admin SDK Directory API in the service registry to improve discoverability.
  • Testing: Added unit tests to verify the resolution of the new Admin Directory API aliases.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Generative AI Prohibited Use Policy, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Google Drive documentation to include instructions for accessing files in shared drives using specific API parameters. It also introduces aliases for the Admin SDK Directory API along with corresponding unit tests. Feedback indicates that the addition of the Admin SDK aliases is considered scope creep and should be moved to a separate pull request to maintain focus.

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.
@googleworkspace-bot
Copy link
Copy Markdown
Collaborator

/gemini review

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds a new section to the Google Drive skill documentation regarding shared drives, along with a changeset. The documentation explains how to use the supportsAllDrives and includeItemsFromAllDrives parameters. Feedback was provided to ensure the parameter syntax matches the JSON format required by the CLI and to clarify that includeItemsFromAllDrives is only valid for list operations to avoid potential errors.

nuthalapativarun and others added 2 commits April 12, 2026 10:46
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@googleworkspace-bot
Copy link
Copy Markdown
Collaborator

/gemini review

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Google Drive skill documentation to include instructions on how to handle shared drives. It adds a new "Shared Drives" section to SKILL.md explaining the use of supportsAllDrives and includeItemsFromAllDrives parameters when files are not found in the default search. A corresponding changeset file has also been added. I have no feedback to provide.

…msFromAllDrives 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
@googleworkspace-bot
Copy link
Copy Markdown
Collaborator

/gemini review

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds documentation regarding shared drives in Google Drive, specifically updating SKILL.md to explain how to use the supportsAllDrives and includeItemsFromAllDrives parameters when searching for or retrieving files. A changeset file was also added to track these documentation changes. I have no feedback to provide.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

update skills document to mention shared drives (supportsAllDrives: true)

2 participants