Google Drive Picker
Overview
The Google Drive Picker allows users to browse and select files, folders, and spreadsheets stored in Google Drive directly from IB-X activities.
The picker provides a familiar Google Drive file selection experience and eliminates the need to manually enter file or folder identifiers.
The Google Drive Picker requires a configured and authorized Google Drive or Google Sheets connection. For setup instructions, see Google Drive and Google Sheets Connection Setup.
Supported Authentication
The Google Drive Picker is supported when using:
- OAuth 2.0
OAuth authentication allows IB-X to access Google Drive resources on behalf of the authenticated user.
Picker Behavior
The Google Drive Picker is available in Google Drive and Google Sheets activities whenever a file, folder, or spreadsheet must be selected from Google Drive.
The type of resources displayed depends on the field being configured.
Only a single resource can be selected at a time.
Supported Resource Types
| Resource Type | Behavior |
|---|---|
| File | Folders can be browsed but cannot be selected. Only files can be selected. |
| Spreadsheet | Folders can be browsed but cannot be selected. Only Google Sheets documents are displayed and can be selected. |
| Folder | Only folders are displayed and can be selected. |
Resource Navigation
The picker supports:
- Browsing folders
- Navigating nested folder structures
- Searching Google Drive content
- Selecting a single supported resource
- Accessing resources visible to the authenticated user
The resources displayed are limited to those accessible by the Google account used to authorize the connection.
Limitations
- Only single-resource selection is supported.
- Users cannot delete files or folders they do not own.
- Access is limited to resources available to the authenticated user.
- Resources restricted by Google Drive permissions may not be visible or selectable.
FileDriveInfo
Many Google activities return information using the FileDriveInfo object.
FileDriveInfo represents a file stored in Google Drive and contains both file metadata and a file reference that can be used by other activities.
FileDriveInfo Structure
| Component | Description |
|---|---|
| Metadata | Information describing the file. |
| File Reference | Information required to retrieve the file contents. |
Metadata
Metadata contains descriptive information about the file without including the file contents.
Common metadata properties include:
| Property | Description |
|---|---|
| Id | Unique Google Drive file identifier. |
| Name | File name. |
| Size | File size in bytes. |
| MimeType | File content type. |
| DriveId | Google Drive identifier. |
| Parents | Parent folder identifiers. |
| WebContentLink | Direct download URL provided by Google. |
| WebViewLink | Browser view URL provided by Google. |
| CreatedTime | Date and time the file was created. |
| ModifiedTime | Date and time the file was last modified. |
| SharedWithMe | Indicates whether the file is shared with the authenticated user. |
For a complete list of metadata properties, refer to the Google Drive API documentation:
https://developers.google.com/workspace/drive/api/reference/rest/v3/files
File Reference
The File Reference contains the information required by IB-X to retrieve file contents from Google Drive.
The File Reference includes:
| Property | Description |
|---|---|
| Connection Name | Google connection used to access the file. |
| File ID | Unique Google Drive file identifier. |
| File Name | Name of the file. |
| Content Type | MIME type of the file. |
File References can be passed between activities to perform operations such as downloading, copying, moving, or processing files.