Skip to content

Google Project setup

This guide will show you how to set up a Google Project and create credentials that will work for sa-gen or similar tools.

It's assuming you're working through the steps from here and have completed the following steps:

This guide is assuming you are using a standard GSuite Business or GSuite Workspace account.

IF YOU HAVE DONE THIS BEFORE IN ANY OTHER CONTEXT [CLOUDBOX, PTS, ETC.], THERE IS NO REASON TO REPEAT IT. You only need one of these projects.

  1. Open Google APIs Console site: https://console.developers.google.com and login with your Google account.

    Click on the project or organization at the top:

  2. Click "New Project":

  3. Name the project. Click "Create".

    You'll see a progress dialog, when it's complete, click "Select Project"

  4. Click "Go to APIs overview".

  5. Click "ENABLE APIS AND SERVICES" at the top.

    You'll be taken to the "API Library":

  6. Search for "Admin". Click "Admin SDK API".

    Click the button to enable the API:

    You'll go to a API Overview page. Click the browser back button twice:

    Repeat this process for six more APIs:

    - Google Drive API
    - Identity and Access Management (IAM) API
    - Cloud Resource Manager API
    - Service Usage API
    - Service Management API
    - Google Sheets API
    

    You may find that some of these APIs have been enabled already as dependencies of others, like Service Management here:

    In that case, click the website back arrow once and move on to the next one.

  7. Now click "APIS and Services" then "Credentials" in the left column to go to the credentials dash:

  8. Click "Configure consent screen" over on the right:

  9. Choose "External" user type and click "Create":

  10. On this screen:

    1. type in the App Name (e.g. Rclone)
    2. Enter a "User support email"
    3. Scroll to the bottom
    4. Enter an email address under "Developer contact information"
    5. Click "SAVE AND CONTINUE".

  11. Click "SAVE AND CONTINUE" on the scopes screen:

    And "BACK TO DASHBOARD" on the final summary:

  12. Click "SAVE AND CONTINUE" on the test users screen:

    And "BACK TO DASHBOARD" on the final summary:

  13. Click "PUBLISH APP" on the dashboard :

    Then "CONFIRM":

  14. Click "Credentials" in the sidebar:

  15. Click "Create Credentials", then "OAuth client ID":

  16. Choose "Desktop App", give the app a name, and click "CREATE":

  17. You'll be presented with the Client ID and Secret. Copy and save them somewhere; you may need them to configure other tools later. Click on "DOWNLOAD JSON" to download the credential file:

Later on, I'm going to assume you put it on the saltbox server in /opt/sa/ and named it project-creds.json.

To do that you may need to create /opt/sa and make sure it's writable by you.

How do I do that?
sudo mkdir -p /opt/sa
sudo chown -R <user>:<group> /opt/sa
Where the two placeholders are the Saltbox user and group [by default `seed:seed`]

If you are going through the manual rclone instructions, continue with the next step