Connect to your users’ Google Drive accounts.
You can find your Google app credentials by visiting your Google Cloud Console dashboard.
You’ll need the following information to set up your Google App with Paragon Connect:
Google Applications using scopes that permit access to certain user data must complete a verification process. Read more about Google’s various API scopes and procceses to verify your usage.
Paragon provides a redirect URL to send information to your Google app. To add the redirect URL to your Google app:
In your Google Cloud Console dashboard, navigate to APIs & Services > Credentials in the sidebar.
Press ”+ Create Credentials”, then select OAuth client ID.
Select “Web application” from the Application type drop-down menu.
Note: You’ll need to configure Google’s consent screen for access to Client ID and Client Secret if you haven’t already.
Under Authorized redirect URIs, press the ”+ Add URI” button.
Paste-in the redirect URL from Paragon.
Press the blue “Create” button.
Google provides you with the Client ID and Client Secret needed for the next steps after adding the redirect URL to your project.
In your Google Cloud Console dashboard, navigate to APIs & Services > Library in the sidebar.
Search for “Google Drive API” from the API Library.
Select the “Google Drive API”.
Press the blue “Enable” button to enable the API for your application.
Select Google Drive from the Integrations Catalog.
Under Integrations > Connected Integrations > Google Drive > Settings, fill out your credentials from the end of Step 1 in their respective sections:
drive
.Press the purple “Save Changes” button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.
Once your users have connected their Google Drive account, you can use the Paragon SDK to access the Google Drive API on behalf of connected users.
See the Google Drive REST API documentation for their full API reference.
Any Google Drive API endpoints can be accessed with the Paragon SDK as shown in this example.
Once your Google Drive account is connected, you can add steps to perform the following actions:
When saving or getting files in Google Drive, you can reference data from previous steps by typing {{
to invoke the variable menu.
Webhook triggers can be used to run workflows based on events in your users’ Google Drive account. For example, you might want to trigger a workflow whenever new files are created in Google Drive to sync your users’ Google Drive files to your application in real-time.
You can find the full list of Webhook Triggers for Google Drive below:
You can allow your user to select files from their Google Drive account in your app with the Paragon SDK.
Enable the Google Picker API
You will need to enable the Google Picker API for your application in order to access the File Picker.
In your Google Cloud Console dashboard, navigate to APIs & Services > Library in the sidebar.
Search for “Google Picker API” from the API Library.
Select the “Google Picker API”.
Press the blue “Enable” button to enable the API for your application.
Creating a Google Drive API Key
To show the Google Drive File Picker, you will need a Google Drive API Key. This key is a separate key from the Client ID you provided to Paragon during integration setup.
Navigate to the Google Cloud Console > APIs & Services > Credentials. Make sure the selected project in the header is your app.
Click Create Credentials.
Select API key.
An API Key value will appear. Copy this value to use in the next step.
Note: While the API Key value is not sensitive and can safely be used in your public application, we recommend restricting the API Key with the following settings:
Read more in Google’s docs for API Key restrictions.
Use the Paragon SDK in your frontend application to show the File Picker in your app.
The SDK provides an ExternalFilePicker
class to load Google’s JavaScript into your page and authenticate with your user’s connected Google Drive account.
You can configure the File Picker to listen for additional callbacks or to restrict allowed file types. Learn more about configuring File Picker options in the SDK Reference.
The Google File Picker callback will return a Response
object describing the user’s file picker interaction including an array of any files selected. Using this array of fileIds
, you can use the Proxy API to perform an authenticated proxy requests to download the files.
Note: Files containing binary content, including photos and videos, should be downloaded using the files.get
endpoint whereas Google Workspace Documents can be downloaded using files.export.
Download a FileExport a Google Doc
Via SDK
Via REST API
Required for publishing: In order to complete the Google application verification process, you must implement the following feature in your integration:
For more information, see Google’s documentation on validation requirements.
Your Google Drive integration requires a Redirect Page hosted in your application to support verification of your application by Google.
The Redirect Page should be implemented as follows:
GET
request with a number of query parameters.https://passport.useparagon.com/oauth
with the same query parameters.If you were previously testing with https://passport.useparagon.com/oauth
as your Google Drive Redirect URL, you will need to update this value after implementing a Redirect Page:
Log into your Google Cloud Console dashboard and select your application.
Navigate to APIs & Services > Credentials and select the credentials you use with Paragon.
Under Authorized redirect URIs, provide the URL of your Redirect Page.
Connect to your users’ Google Drive accounts.
You can find your Google app credentials by visiting your Google Cloud Console dashboard.
You’ll need the following information to set up your Google App with Paragon Connect:
Google Applications using scopes that permit access to certain user data must complete a verification process. Read more about Google’s various API scopes and procceses to verify your usage.
Paragon provides a redirect URL to send information to your Google app. To add the redirect URL to your Google app:
In your Google Cloud Console dashboard, navigate to APIs & Services > Credentials in the sidebar.
Press ”+ Create Credentials”, then select OAuth client ID.
Select “Web application” from the Application type drop-down menu.
Note: You’ll need to configure Google’s consent screen for access to Client ID and Client Secret if you haven’t already.
Under Authorized redirect URIs, press the ”+ Add URI” button.
Paste-in the redirect URL from Paragon.
Press the blue “Create” button.
Google provides you with the Client ID and Client Secret needed for the next steps after adding the redirect URL to your project.
In your Google Cloud Console dashboard, navigate to APIs & Services > Library in the sidebar.
Search for “Google Drive API” from the API Library.
Select the “Google Drive API”.
Press the blue “Enable” button to enable the API for your application.
Select Google Drive from the Integrations Catalog.
Under Integrations > Connected Integrations > Google Drive > Settings, fill out your credentials from the end of Step 1 in their respective sections:
drive
.Press the purple “Save Changes” button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.
Once your users have connected their Google Drive account, you can use the Paragon SDK to access the Google Drive API on behalf of connected users.
See the Google Drive REST API documentation for their full API reference.
Any Google Drive API endpoints can be accessed with the Paragon SDK as shown in this example.
Once your Google Drive account is connected, you can add steps to perform the following actions:
When saving or getting files in Google Drive, you can reference data from previous steps by typing {{
to invoke the variable menu.
Webhook triggers can be used to run workflows based on events in your users’ Google Drive account. For example, you might want to trigger a workflow whenever new files are created in Google Drive to sync your users’ Google Drive files to your application in real-time.
You can find the full list of Webhook Triggers for Google Drive below:
You can allow your user to select files from their Google Drive account in your app with the Paragon SDK.
Enable the Google Picker API
You will need to enable the Google Picker API for your application in order to access the File Picker.
In your Google Cloud Console dashboard, navigate to APIs & Services > Library in the sidebar.
Search for “Google Picker API” from the API Library.
Select the “Google Picker API”.
Press the blue “Enable” button to enable the API for your application.
Creating a Google Drive API Key
To show the Google Drive File Picker, you will need a Google Drive API Key. This key is a separate key from the Client ID you provided to Paragon during integration setup.
Navigate to the Google Cloud Console > APIs & Services > Credentials. Make sure the selected project in the header is your app.
Click Create Credentials.
Select API key.
An API Key value will appear. Copy this value to use in the next step.
Note: While the API Key value is not sensitive and can safely be used in your public application, we recommend restricting the API Key with the following settings:
Read more in Google’s docs for API Key restrictions.
Use the Paragon SDK in your frontend application to show the File Picker in your app.
The SDK provides an ExternalFilePicker
class to load Google’s JavaScript into your page and authenticate with your user’s connected Google Drive account.
You can configure the File Picker to listen for additional callbacks or to restrict allowed file types. Learn more about configuring File Picker options in the SDK Reference.
The Google File Picker callback will return a Response
object describing the user’s file picker interaction including an array of any files selected. Using this array of fileIds
, you can use the Proxy API to perform an authenticated proxy requests to download the files.
Note: Files containing binary content, including photos and videos, should be downloaded using the files.get
endpoint whereas Google Workspace Documents can be downloaded using files.export.
Download a FileExport a Google Doc
Via SDK
Via REST API
Required for publishing: In order to complete the Google application verification process, you must implement the following feature in your integration:
For more information, see Google’s documentation on validation requirements.
Your Google Drive integration requires a Redirect Page hosted in your application to support verification of your application by Google.
The Redirect Page should be implemented as follows:
GET
request with a number of query parameters.https://passport.useparagon.com/oauth
with the same query parameters.If you were previously testing with https://passport.useparagon.com/oauth
as your Google Drive Redirect URL, you will need to update this value after implementing a Redirect Page:
Log into your Google Cloud Console dashboard and select your application.
Navigate to APIs & Services > Credentials and select the credentials you use with Paragon.
Under Authorized redirect URIs, provide the URL of your Redirect Page.