diff --git a/src/generate-mint.ts b/src/generate-mint.ts index 209d567f..60f8a1bd 100644 --- a/src/generate-mint.ts +++ b/src/generate-mint.ts @@ -209,6 +209,7 @@ const mintConfig: MintConfig = { "provider-guides/gitlab", "provider-guides/gong", "provider-guides/google", + "provider-guides/googleMeet", "provider-guides/gorgias", "provider-guides/goToWebinar", "provider-guides/groove", diff --git a/src/images/provider-guides/googleMeet.gif b/src/images/provider-guides/googleMeet.gif new file mode 100644 index 00000000..2c1b3cad Binary files /dev/null and b/src/images/provider-guides/googleMeet.gif differ diff --git a/src/images/provider-guides/googleMeetEnable.png b/src/images/provider-guides/googleMeetEnable.png new file mode 100644 index 00000000..440dc547 Binary files /dev/null and b/src/images/provider-guides/googleMeetEnable.png differ diff --git a/src/images/provider-guides/googleMeetScopes.png b/src/images/provider-guides/googleMeetScopes.png new file mode 100644 index 00000000..086b63e8 Binary files /dev/null and b/src/images/provider-guides/googleMeetScopes.png differ diff --git a/src/mint.json b/src/mint.json index 7f4da21c..45f726c3 100644 --- a/src/mint.json +++ b/src/mint.json @@ -144,6 +144,7 @@ "provider-guides/gitlab", "provider-guides/gong", "provider-guides/google", + "provider-guides/googleMeet", "provider-guides/gorgias", "provider-guides/goToWebinar", "provider-guides/groove", diff --git a/src/provider-guides/googleMeet.mdx b/src/provider-guides/googleMeet.mdx new file mode 100644 index 00000000..69e8b744 --- /dev/null +++ b/src/provider-guides/googleMeet.mdx @@ -0,0 +1,109 @@ +--- +title: "Google Meet" +--- + + +## What's Supported + +### Supported Actions + +This connector supports: +- [Proxy Actions](/define-integrations/proxy-actions), using the base URL `https://meet.googleapis.com`. + +## Before You Get Started + +To integrate Google Meet with Ampersand, you will need a [Google Cloud account](https://cloud.google.com/). + +Once your account is created, you'll need to create a Google app, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app: + +- Client ID +- Client Secret +- Scopes + +You will then use these credentials to connect your application to Ampersand. + +### Create a Google Cloud Account + +You can sign up for a [free Google Cloud account here](https://cloud.google.com/free). + +### Enable the appropriate APIs + +Go to the [API Library page](https://console.cloud.google.com/apis/library) of Google Cloud Console and search for `Google Meet`, select it and click the "Enable" button. + +![API Library](/images/provider-guides/googleMeetEnable.png) + + +### Creating a Google App + +Follow the steps below to create a Google App: + +1. Go to the [OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent) page, pick "External" as the User Type. + +![OAuth Consent](/images/provider-guides/1537ae6-Screenshot_2024-07-19_at_10.40.32_AM.png) + +
+ +2. Enter the information required on the next page, click "Save and Continue". + +**Important information about App Logo**: when you are creating a Google app for development purposes, do not upload a logo. Uploading a logo will trigger an app verification process. When you are ready to submit your app for review by Google, then you can come back to this page and upload a logo. + +![App Logo](/images/provider-guides/5600533-Screenshot_2024-07-19_at_10.56.54_AM.png) + +3. On the Scopes page, click "Add or Remove Scopes", and then select the scopes that Google Meet integration will need. "Google Meet" into the search box and select the scopes you will need. If the scopes you require are not popping up, ensure that you've enabled the appropriate APIs (previous step), and then refresh the page. + +![Scopes](/images/provider-guides/googleMeetScopes.png) + +4. On the Test Users page, click "+ Add Users" to add up to 100 email addresses, and then click "Save and Continue". + +![Add Users](/images/provider-guides/b3953c3-Screenshot_2024-07-19_at_1.46.54_PM.png) + +### Creating Client ID and Client Secret + +1. Once your Google App has been created, go to the [Credentials page](https://console.cloud.google.com/apis/credentials) of Google Cloud Console. Click on "Create Credentials" and then select "OAuth Client ID". + +![Create Credentials](/images/provider-guides/2a3a0ed-Screenshot_2024-07-19_at_11.07.26_AM.png) + +2. Click "Web Application" from the Application Type dropdown menu. + +![Web Application](/images/provider-guides/4071e04-Screenshot_2024-07-19_at_11.08.21_AM.png) + +3. In the name box, write down a descriptive name like "Ampersand Integration". Under "Authorized redirect URIs", add `https://api.withampersand.com/callbacks/v1/oauth`. Click "Create". + +![Authorized Redirect URIs](/images/provider-guides/897fe36-fixed.png) + +4. There will be a popup which displays the Client ID and Client Secret, you'll need to add these to the Ampersand Dashboard in the next step. You can either copy and paste these values, or click "Download JSON". + +![Client ID and Client Secret](/images/provider-guides/d0de0fe-GoogleOAuthClient.png) + +## Add Your Google App info to Ampersand + +1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com). + +2. Select the project where you want to create a Google integration. + + ![Ampersand Project](/images/provider-guides/dd47b7a-Ampersand.png) + +3. Select **Provider apps**. + +4. Select _Google Meet_ from the **Provider** list. + +5. Enter the previously obtained _Client ID_ in the **Client ID** field and the _Client Secret_ in the **Client Secret** field. In the **Scopes** field, enter each of your scopes on a separate line, and prefix each scope with `https://www.googleapis.com/auth`. + +![Scopes](/images/provider-guides/googleMeet.gif) + +6. Click **Save changes**. + +## Ship your integration to production + +When you are ready to use your integration with external customers, you'll need to go through the Google App verification process. + +1. Go back to the [OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent) page, click on "Edit App" to upload a logo and fill out all the form fields (such as Privacy Page, Terms of Service). +2. After saving your changes, click on the "Publish App" button under "Publishing Status". + +![Publish App](/images/provider-guides/ee95f57-Screenshot_2024-07-19_at_11.42.12_AM.png) + +3. Then click on the "Prepare for Verification" button that should now be visible, follow the instructions on the screen. + +![Prepare for Verification](/images/provider-guides/7fb1236-Screenshot_2024-07-19_at_11.46.20_AM.png) + +For more information about the Google verification process, see [Google Support docs](https://support.google.com/cloud/answer/13463073?sjid=12970809243513943038-NC)