Skip to content

Google: Lists the user's files For more information, see Search for files and folders (https: developers google com workspace drive api guides search-files) This method accepts the `q` parameter, which is a search query combining one or more search terms This method returns *all* files by default, including trashed files If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results — response body

Lists the user's files. For more information, see [Search for files and folders](https://developers.google.com/workspace/drive/api/guides/search-files). This method accepts the `q` parameter, which is a search query combining one or more search terms. This method returns *all* files by default, including trashed files. If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results.: response body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Lists the user's files For more information, see Search for files and folders (https: developers google com workspace drive api guides search-files) This method accepts the `q` parameter, which is a search query combining one or more search terms This method returns *all* files by default, including trashed files If you don't want trashed files to appear in the list, use the `trashed=false` query parameter to remove trashed files from the results — response body

FieldTypePresenceDescription and constraints
$objectRootA list of files.
filesarrayOptionalThe list of files. If `nextPageToken` is populated, then this list may be incomplete and an additional page of results should be fetched.
files[]ModelEach itemExpand Creates a copy of a file and applies any requested updates with patch semantics For more information, see Create and manage files (https: developers google com workspace drive api guides create-file) — response body
incompleteSearchbooleanOptionalWhether the search process was incomplete. If true, then some search results might be missing, since all documents were not searched. This can occur when searching multiple drives with the `allDrives` corpora, but all corpora couldn’t be searched. When this happens, it’s suggested that clients narrow their query by choosing a different corpus such as `user` or `drive`.
kindstringOptionalIdentifies what kind of resource this is. Value: the fixed string `“drive#fileList”`.
Default: drive#fileList
nextPageTokenstringOptionalThe page token for the next page of files. This will be absent if the end of the files list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ.

Referenced models: Creates a copy of a file and applies any requested updates with patch semantics For more information, see Create and manage files (https: developers google com workspace drive api guides create-file) — response body

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.