# Create a Google App ## Create a New Project 1. Go to You'll see one of these New Project screen options depending on whether your google account is part of an organization (google workspace) or not. ***New Project view for personal Google accounts***
***New Project view for Google workspace accounts***
2. Add a name for your project. 3. For google workspace accounts, select your project's **Organization** and **Location**. 4. Click on the **CREATE** button. Once your new project has been created, you'll get a notification that looks like this:
5. Click the **SELECT PROJECT** link in the notification. ## Enable APIs for Your Project 1. From the Google Cloud dashboard, go to **APIs and Services** on the left menu and then click on **Enabled APIs and Services**.
2. Click on **+ ENABLE APIS AND SERVICES** This should open up the API Library
3. Search for and enable the following APIs 1. **Google Calendar API** - required for reading calendars and performing CRUD operations on calendar events. 2. **Google People API** - required for reading user info such as name and email address. 3. **Admin SDK API** - required for reading room info for calendar events.
## Configure OAuth Screen After you've enabled all the APIs, you must configure your Google App's OAuth consent screen. This is the page users will see when authenticating/allowing your app access to their Google account. 1. From the Google Cloud dashboard, hover over **APIs & Services** on the left menu. Then click on **OAuth consent screen**
2. For User Type, choose either **Internal** or **External**, depending on your use case. Choose Internal if your app will only be used by users from your organization. Choose External if you want anyone with a Gmail account to be able to use your app. External apps require verification by Google before you can go to production. ### OAuth Screen Steps 1. Fill out all required info for the OAuth screen. 2. Add `pyas.io` to your **Authorized domains** list 3. Add your developer contact email 4. Click on **SAVE AND CONTINUE**
5. Next, click **ADD OR REMOVE SCOPES**
6. Copy the scopes below and paste them into the **Manually add scopes** textarea. ***Scopes to use:*** ``` https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/userinfo.profile openid https://www.googleapis.com/auth/calendar.events https://www.googleapis.com/auth/calendar.freebusy https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly https://www.googleapis.com/auth/calendar.calendarlist.readonly https://www.googleapis.com/auth/calendar.calendars.readonly ```
7. Click **ADD TO TABLE** and then click **UPDATE**
8. Click **SAVE AND CONTINUE**
9. If you selected **External** for the User Type, the next step will be to add test users. Click the **+ADD USERS** button on the Test users screen.
10. Enter up to 100 email addresses for your test users and then click **ADD**.
11. Click **SAVE AND CONTINUE**
12. Review the summary and then click **BACK TO DASHBOARD**
13. When you're ready to go to production with your Google App, click the **PUBLISH APP** button. ### Create Credentials The next thing you need to do is create OAuth credentials for your app. You will need to provide these credentials to Pyas later so we authenticate your users and access their calendars through our API. 1. From the Google Cloud dashboard, under APIs & Services, click on Credentials.
2. Click on **CREATE CREDENTIALS** and then select **OAuth client ID**
3. For Application Type, select **Web Application** 4. Give your application a name 5. Add authorized redirect URIs. 1. Be sure to add `https://www.app.pyas.io/org/apps/oauth/google/callback` as an authorized redirect URI 2. Also add `https://api.pyas.io/oauth/google/callback` as an authorized redirect URI 3. Add your own redirect URI that you plan on using for your app
6. Click **CRERATE** 7. There should now be a popup with your OAuth credentials. Save them so you can add them to your Pyas account later.
### Add Your Google OAuth Client ID and Client Secret to Pyas 1. Login to your Pyas account 2. Select the Pyas App you will be updating 3. Go to the Pyas App's settings tab 4. Click on Authentication 5. Under **Pyas Authentication**, toggle the **Enable Pyas Auth for Google Accounts** switch off. Then, click the **Save Pyas Auth Settings** button.
6. Scroll down to the **Native Google Authentication** section.
7. Fill in the **Google Oauth Client ID**, **Google Oauth Client Secret**, and **Google Oauth Callback URL.** Note: the Google Oauth Callback URL should be your authorized redirect url that you added back in the **Create Credentials** section of this guide. 8. Once you've added the Google Oauth info, click the **Save Google Settings** button. **That's it!** You should now be able to use your Google App with Pyas to add Google Calendar integrations into your app.