-
Notifications
You must be signed in to change notification settings - Fork 1
Search Query
Use search query to limit results by the file's metadata.
Download all files names that match *2014*:
./kumodd -d all -q "title contains '2014'"
Download all files except files names that match *hello*:
./kumodd -d all -q "not name contains 'hello'"
Download all files that contain the word 'thorax'. This is a full text search of file contents.
./kumodd -d all -q "fullText contains 'thorax'"
Download all files edited by a given user:
./kumodd -d all -q "'john.doe@gmail.com' in writers"
Download all files modified on or after 1/1/2012 00:00:00 UTC:
./kumodd -d all -q "modifiedTime > '2012-01-01T00:00:00'"
List all PDFs viewed by the account holder on or after 1/1/2012 00:00:00 UTC:
./kumodd -d pdf -q "viewedByMeTime > '2012-01-01T00:00:00'"
Dates are in RFC3339 format, and the default timezone is UTC.
For more details on the query syntax, see the Google Drive API Referencce.
Results include files in the trash. Files from the trash have the metadata attribute, labels.trashed == true.
Results will include malware or other abusive files if present. Kumodd does this by setting acknowledgeAbuse=true when downloading files from Google Drive.
Results will include files in Team drives and Shared drives.
Filters are short names for file classifications, such as doc or image. How to Use Kumodd shows examples of using filiters.
Each filter has an equivalent query, as follows.
| Filter | Equivalent Query |
|---|---|
| -d doc | -d all -q "mimeType = 'application/msword' or mimeType = 'application/vnd.openxmlformats-officedocument.wordprocessingml' or mimeType = 'application/vnd.ms-word' or mimeType = 'application/vnd.google-apps.document'" |
| -d xls | -d all -q "mimeType = 'application/vnd.ms-excel' or mimeType = 'application/vnd.openxmlformats-officedocument.spreadsheetml' or mimeType = 'application/vnd.google-apps.spreadsheet'" |
| -d ppt | -d all -q "mimeType = 'application/vnd.ms-powerpoint' or mimeType = 'application/vnd.openxmlformats-officedocument.presentationml' or mimeType = 'application/vnd.google-apps.presentation'" |
| -d pdf | -d all -q "mimeType = 'application/pdf'" |
| -d text | -d all -q "mimeType contains 'text/'" |
| -d image | -d all -q "mimeType contains 'image/'" |
| -d audio | -d all -q "mimeType contains 'audio/'" |
| -d video | -d all -q "mimeType contains 'video/'" |
Google Apps can open mimeTypes listed here: https://developers.google.com/drive/api/v3/mime-types
An extensive list of mimeTypes is listed in MimeType.cs.
The default scope is https://www.googleapis.com/auth/drive.readonly. This provides read only access to all files and metadata in the user's 'My Drive' folder. This excludes the Application Data folder.
For photos, select: --scope https://www.googleapis.com/auth/drive.photos.readonly
For app data, select: --scope https://www.googleapis.com/auth/drive.appdata
The default corpus is 'user'. Select a different corpus using the --corpera option.
The user corpus includes all files in "My Drive" and "Shared with me".
The domain corpus includes all files shared to the user's domain that are searchable.
The drive corpus includes all files contained in a single shared drive.
The allDrives corpus includes all files in shared drives that the user is a member of and all files in "My Drive" and "Shared with me." Use of the allSharedDrives corpus is discouraged for efficiency reasons. Prefer 'drive' or 'user' for efficiency.
The default space is 'drive'. Use the --spaces option to select a comma-separated list of spaces to query within the corpus. Supported values are 'drive', 'appDataFolder' and 'photos'.