list_drive_items
Retrieve and format files and folders from Google Drive, including shared drives. Specify a user's email, folder or drive ID, and optional parameters to list items efficiently.
Instructions
Lists files and folders, supporting shared drives.
If drive_id
is specified, lists items within that shared drive. folder_id
is then relative to that drive (or use drive_id as folder_id for root).
If drive_id
is not specified, lists items from user's "My Drive" and accessible shared drives (if include_items_from_all_drives
is True).
Args:
user_google_email (str): The user's Google email address. Required.
folder_id (str): The ID of the Google Drive folder. Defaults to 'root'. For a shared drive, this can be the shared drive's ID to list its root, or a folder ID within that shared drive.
page_size (int): The maximum number of items to return. Defaults to 100.
drive_id (Optional[str]): ID of the shared drive. If provided, the listing is scoped to this drive.
include_items_from_all_drives (bool): Whether items from all accessible shared drives should be included if drive_id
is not set. Defaults to True.
corpora (Optional[str]): Corpus to query ('user', 'drive', 'allDrives'). If drive_id
is set and corpora
is None, 'drive' is used. If None and no drive_id
, API defaults apply.
Returns: str: A formatted list of files/folders in the specified folder.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
corpora | No | ||
drive_id | No | ||
folder_id | No | root | |
include_items_from_all_drives | No | ||
page_size | No | ||
user_google_email | Yes |