Google Cloud projects
Connecting Ultradox to your own Google Cloud project
Creating your own cloud project has some advantages:
You can give it a nice name so that users will be prompted to grant access to your app instead of granting access to Ultradox.
When creating apps that request access to Google services like GMail or Google Drive on behalf of the user of your app, creating a dedicated project will allow you to verify your app with Google to get rid of the warning or access restrictions for your users.
Optionally you can log messages to your cloud project to take full advantage of Google's Stackdriver logging.
Google started to restrict the access to several services like GMail and Google Drive to improve security.
Creating your own Google Cloud project will allow you to using these restricted services with Ultradox.
Seting the project
To create a new or select an existing dedicated cloud project for your app or automation, click on Set GCP Project in the File menu.
If you are connecting Ultradox to your own cloud project for the first time you will be prompted to grant access to the Google Cloud Platform services.
Authorize Ultradox so that a new project can be created or an existing project can be linked to Ultradox.
After authorizing Ultradox click on the Set GCP Project menu item again to open the project picker.
The project picker will show all of your Google Cloud projects and lets you select an existing project or create a new project.
If you have already configured your own Google Cloud project to work with Ultradox, feel free to connect as many automations with the same project as you like.
Creating a new project
When creating a new Google Cloud project to be used with Ultradox you can give it a name.
By default the name of the current file will be used.
The project ID must be unique across all the Google Cloud, so keeping the suggested name ID may be a good idea.
Configuring the project
After the project has been created, you will have to perform a number of steps so that Ultradox can be connected to the project.
Follow the next steps carefully! If you miss a single one of them you will not be able to connect Ultradox to your project.
Consent Screen
First of all configure the OAuth consent screen for your project.
Choose the name wisely as it will be displayed when you or users of your app will be prompted to grant access to Google services.
Do NOT upload an application logo unless you want to submit your project for verification.
Uploading an application logo will force you to go through the Google verification process and cannot be undone.
Add ultradox.com to the list of authorized domains.
This will allow Ultradox to display the authorization popup for your cloud project.
Save the consent screen.
Creating an API key
Next you will have to create credentials that Ultradox will use to access your project.
Go to the credentials configuration page in the Google Cloud Console, click on Create credentials and select API key.
Google will create a new API key that will be used to identify your project when accessing Google services.
A window will pop up and show the generated API key.
Copy the API key and paste it into the dedicated input field in the Ultradox project configuration dialog.
Creating an OAuth client
Click on Create credentials again and select OAuth client ID.
Select Web application and enter Ultradox client as a name.
Enter either
https://www.ultradox.com/auth
or
https://eu.ultradox.com/auth
into the Authorized redirect URIs text field.
This will allow Ultradox to perform the authorization flow depending on the Ultradox version you are using.
Click on Create to generate the OAuth client.
A window will pop up and show the generated OAuth client ID and secret.
Copy the client ID and paste it into the dedicated input field in the Ultradox project configuration dialog.
Also copy the client secret and paste it into the dedicated input field.
Click on Apply in the Ultradox project configuration dialog to store the secret credential data and close the dialog.
Enable API
We are almost there! You will finally have to enable the services that you want to use with Ultradox.
First of all you'll have to enable the Google People API to allow users to be authenticated.
You most certainly will also enable the Google Drive API and the GMail API to leverage all features of Ultradox with your shiny new project.
Enable any other Google service that you may want to use from the API Library.
Testing your project
Congratulations! Your new project is connected to your Ultradox automation and is ready to use.
Let's test if everything works as expected by adding a List files building block to our automation.
A dialog will pop up to request access to View metadata for files in your Google Drive in order to be able to list files in a given folder.
Click on Authorize to start the authorization flow.
After selecting the Google account that you want to use to access Google Drive a wanting message will pop up.
We can safely ignore the warning as it comes from our own cloud project.
Show more options by clicking on the Advanced button and click on the Go to ultradox.com (unsafe) link.
After clicking on the link you will be prompted to grant access. You will then be able to use the List files block without any restrictions after completing the authorization flow.
If you want to verify your app to get rid of this warning, please read this guide.
Checking permissions
You can click on the Accounts button in the main Ultradox toolbar to test or revoke access to the granted services.
The little gray box below the bold description of each service indicates which cloud project has been used to authorize it.
My app shows up right blow View metadata for files… and shows that our new Google Cloud project has been used for authorizing this service.
Questions and Feedback
If you have any comments on this page, feel free to add suggestions right to the Google document that we are using to create this site.
If you are not yet member of the Ultradox community on Google+, please join now to get updates from our end or to provide feedback, bug reports or discuss with other users.
Last Updated: 8/20/20