rowboat/google-setup.md

138 lines
No EOL
2.7 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Connecting Google to Rowboat
Rowboat requires a Google OAuth Client ID to connect to Gmail, Calendar, and Drive. Follow the steps below to generate your Client ID correctly.
---
## 1⃣ Open Google Cloud Console
Go to:
https://console.cloud.google.com/
Make sure youre logged into the Google account you want to use.
---
## 2⃣ Create a New Project
Go to:
https://console.cloud.google.com/projectcreate
- Click **Create Project**
- Give it a name (e.g. `Rowboat Integration`)
- Click **Create**
Once created, make sure the new project is selected in the top project dropdown.
![Select the new project in the dropdown](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.14.11.png)
---
## 3⃣ Enable Required APIs
Enable the following APIs for your project:
- Gmail API
https://console.cloud.google.com/apis/api/gmail.googleapis.com
- Google Calendar API
https://console.cloud.google.com/apis/api/calendar-json.googleapis.com
- Google Drive API
https://console.cloud.google.com/apis/api/drive.googleapis.com
For each API:
- Click **Enable**
![Enable the API](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.44.37.png)
---
## 4⃣ Configure OAuth Consent Screen
Go to:
https://console.cloud.google.com/auth/branding
### App Information
- App name: (e.g. `Rowboat`)
- User support email: Your email
### Audience
- Choose **External**
### Contact Information
- Add your email address
Click **Save and Continue** through the remaining steps.
You do NOT need to publish the app — keeping it in **Testing** mode is fine.
![OAuth consent screen](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.32.31.png)
---
## 5⃣ Add Test Users
If your app is in Testing mode, you must add users manually.
Go to:
https://console.cloud.google.com/auth/audience
Under **Test Users**:
- Click **Add Users**
- Add the email address you plan to connect with Rowboat
Save changes.
![Add test users](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.34.30.png)
---
## 6⃣ Create OAuth Client ID
Go to:
https://console.cloud.google.com/auth/clients
Click **Create Credentials → OAuth Client ID**
### Application Type
Select:
**Universal Windows Platform (UWP)**
- Name it anything (e.g. `Rowboat Desktop`)
- Store ID can be anything (e.g. `test` )
- Click **Create**
![Create OAuth Client ID (UWP)](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.37.20.png)
---
## 7⃣ Copy the Client ID
After creation, Google will show:
- **Client ID**
- **Client Secret**
Copy the **Client ID** and paste it into Rowboat where prompted.
![Copy Client ID](apps/docs/docs/img/google-setup/Screenshot 2026-02-10 at 14.38.37.png)
---