api_key_google

Text

The Google API key required to authenticate and access the Google Picker and Google Drive APIs. This key allows your application to securely communicate with Google services. It must be generated from the Google Cloud Console for your specific project. If this value is invalid or missing, the plugin will not connect to Google services.

-

client_id_google

Text

The OAuth 2.0 client ID that identifies your application to Google. This ID is essential for the authentication and authorization process that allows users to access their Google Drive files through your application. It must be generated specifically for web applications in the Google Cloud Console.

-

app_id_google

Text

The Google app ID associated with your Google Cloud project. This identifier links requests to the API with your specific project and is necessary for the Picker API to function correctly.

-

language

Text

Language code that determines the language of the Google Picker interface. For example, 'es' for Spanish, 'en' for English, 'fr' for French, etc. This value affects all texts, buttons, and messages displayed in the Google Drive picker interface. If left blank, the plugin will automatically use the language configured in the user's browser (navigator.language). If the browser's language is unavailable or cannot be determined, 'es' (Spanish) will be used as the default.

Browser Language

view_mode

Dropdown

Defines the operation mode of the Google Drive picker, determining what type of interaction and results will be provided.

select

file_type

Dropdown (List)

Defines which types of files will be displayed in the Google Drive picker. This setting filters the files that users can view and select, making navigation and selection easier when only certain file types are required.

all

allow_multiple_selection

Checkbox

Determines whether users can select multiple files at once in the picker. When enabled, users can hold down the Ctrl key (or Cmd on Mac) to select multiple files. When disabled, only one file can be selected at a time. Useful for limiting selection to a single file when processing or displaying one item at a time is required.

Enabled

max_files

Number

Sets the maximum number of files a user can select simultaneously. This limitation applies after the user completes their selection and helps prevent overloading during file processing. If a user selects more files than allowed, a custom error message is displayed, and the selection is not processed. If left blank or set to null, there will be no limit on the number of selectable files.

No limit (null)

max_file_size

Number

Defines the maximum allowed size for each individual file in megabytes (MB). Files exceeding this size are automatically excluded from the final selection. This limitation prevents performance issues when uploading large files or storage restrictions. If users select files exceeding this limit, a custom warning message is displayed, and the files are filtered out. If left blank or set to null, there will be no size restriction.

No limit (null)

enable_file_upload

Checkbox

Controls whether users can upload new files to Google Drive directly from the picker. When enabled, an additional option appears in the picker allowing users to upload files from their device. These files are saved to Google Drive and can then be selected immediately. When disabled, users can only select files already existing in their Google Drive.

Enabled

error_message

Text

Custom message displayed when a user selects more files than allowed by themax_filessetting. You can customize this message to provide clear instructions to users about selection limitations. The text can include the variable{max_files}, which will be automatically replaced with the configured value.

"You have selected more files than allowed. Please select up to {max_files} files."

warning_message

Text

Custom message displayed when some of the selected files exceed the maximum allowed size configured inmax_file_size. This message informs users that certain files have been excluded from the selection due to size restrictions. The text can include the variable{max_file_size}, which will be automatically replaced with the configured value in MB.

"Some files exceed the maximum allowed size of {max_file_size} MB and have been excluded."

allowed_origins

Text

Defines the origins (domains) from which the plugin is allowed to run. This is a critical security measure that prevents unauthorized use of the plugin from unapproved domains. It can be configured as a comma-separated list of domains or an array of strings. Wildcards (e.g.,*.mydomain.com) are supported to allow all subdomains of a specific domain. If left blank or not configured, the plugin will only work on the domain where the Bubble application is hosted. This configuration is essential to prevent unauthorized use of your Google API keys and comply with best security practices.

Current application domain

strict_security

Checkbox

Enables additional and strict security checks during plugin operation. When enabled, the plugin verifies the runtime environment and blocks operations in environments considered insecure (such as non-HTTPS connections, presence of open developer tools, or execution within unauthorized iframes). This setting provides an additional layer of protection against malicious use but may limit functionality in certain development environments.

Disabled

inactivity_timeout

Number

Sets the inactivity timeout in minutes before the user's session expires automatically. When this time is reached without user interaction (no mouse movements, key presses, or clicks), the access token is removed, and thesession_expiredevent is triggered. This feature enhances security by automatically closing inactive sessions. If set to 0, the inactivity timeout feature is disabled.

0 (disabled)