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.
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.
Creating a new project
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.
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.
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.
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.
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.
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.
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: 29.11.19