From 1bd1a844131fb18d9da24169eb2e31603c32ae86 Mon Sep 17 00:00:00 2001 From: maddiefranke Date: Fri, 3 Apr 2026 16:52:07 +0000 Subject: [PATCH 1/7] Add Google Workspace connection documentation Covers OAuth2 setup, scope selection, and connection creation in Datadog for Gmail, Calendar, Drive, Docs, Sheets, Forms, and Chat. --- .../actions/connections/google_workspace.md | 168 ++++++++++++++++++ 1 file changed, 168 insertions(+) create mode 100644 content/en/actions/connections/google_workspace.md diff --git a/content/en/actions/connections/google_workspace.md b/content/en/actions/connections/google_workspace.md new file mode 100644 index 00000000000..e0a4292341b --- /dev/null +++ b/content/en/actions/connections/google_workspace.md @@ -0,0 +1,168 @@ +--- +title: Google Workspace +description: Connect Datadog Actions to Google Workspace services using OAuth2 to automate tasks in Gmail, Calendar, Drive, Docs, Sheets, Forms, and Chat. +disable_toc: false +further_reading: +- link: "/actions/connections/" + tag: "Documentation" + text: "Find out more about connection credentials" +--- + +Use a Google Workspace connection to authenticate Datadog Actions against Google Workspace APIs. This allows you to interact with Gmail, Google Calendar, Google Drive, Google Docs, Google Sheets, Google Forms, and Google Chat in your workflows and apps. + +## Prerequisites + +Before creating the connection in Datadog, you must set up an OAuth2 client in Google Cloud. + +### 1. Create a Google Cloud project + +If you don't already have a Google Cloud project: + +1. Go to the [Google Cloud Console][1]. +1. Click **Select a project** > **New Project**. +1. Enter a project name and click **Create**. + +### 2. Enable the required APIs + +Enable the Google APIs you plan to use in your workflows: + +1. In the Google Cloud Console, navigate to **APIs & Services** > **Library**. +1. Search for and enable the APIs for the Google Workspace services you intend to use: + +| Google Workspace service | API to enable | +|---|---| +| Gmail | Gmail API | +| Google Calendar | Google Calendar API | +| Google Drive | Google Drive API | +| Google Docs | Google Docs API | +| Google Sheets | Google Sheets API | +| Google Forms | Google Forms API | +| Google Chat | Google Chat API | + +### 3. Configure the OAuth consent screen + +1. In the Google Cloud Console, navigate to **APIs & Services** > **OAuth consent screen**. +1. Select a user type: + - **Internal**: Limits access to users in your Google Workspace organization. Recommended for most enterprise use cases. + - **External**: Allows any Google account to authorize. Requires app verification for production use. +1. Fill in the required app information fields and click **Save and Continue**. +1. Under **Scopes**, add the OAuth scopes required for the actions you intend to use. See the [scopes reference](#scopes-reference) below. +1. Complete the remaining steps and click **Back to Dashboard**. + +### 4. Create OAuth2 credentials + +1. In the Google Cloud Console, navigate to **APIs & Services** > **Credentials**. +1. Click **Create Credentials** > **OAuth client ID**. +1. For **Application type**, select **Web application**. +1. Under **Authorized redirect URIs**, add the Datadog OAuth callback URL. This URL is displayed in the Datadog connection creation dialog when you select **Google Workspace**. +1. Click **Create**. +1. Copy the **Client ID** and **Client Secret** — you need these when creating the connection in Datadog. + +## Create the connection in Datadog + +1. From the [Workflow Automation page][2] or the [App Builder page][3], click the **Connections** tab. +1. Click **New Connection**. +1. Select the **Google Workspace** icon. +1. Enter a **Connection Name**. +1. Enter the **Client ID** and **Client Secret** from your Google Cloud OAuth2 credentials. +1. Select the **Scopes** required for the actions you plan to use. See the [scopes reference](#scopes-reference) below. +1. The **Authorize URL** and **Token URL** fields are pre-populated with Google's default OAuth2 endpoints. Leave these as-is unless you have a specific reason to change them. +1. Click **Create**. +1. In the authorization window that opens, sign in with the Google account you want to use and grant the requested permissions. + +## Scopes reference + +Select only the scopes required by the actions you intend to use. + +### Gmail + +| Scope label | Scope value | Description | +|---|---|---| +| Gmail: Full Access | `https://mail.google.com/` | Full read and write access to all Gmail resources | +| Gmail: Read, Compose, Send, and Permanently Delete Threads | `https://www.googleapis.com/auth/gmail.modify` | All access except deleting permanently | +| Gmail: Read Only | `https://www.googleapis.com/auth/gmail.readonly` | View email messages and settings | +| Gmail: Send Only | `https://www.googleapis.com/auth/gmail.send` | Send email on behalf of the user | +| Gmail: Compose and Send | `https://www.googleapis.com/auth/gmail.compose` | Manage drafts and send email | +| Gmail: Manage Labels | `https://www.googleapis.com/auth/gmail.labels` | Create, read, update, and delete labels | +| Gmail: View Metadata Only | `https://www.googleapis.com/auth/gmail.metadata` | View email metadata such as labels and headers | + +### Google Calendar + +| Scope label | Scope value | Description | +|---|---|---| +| Calendar: Full Access | `https://www.googleapis.com/auth/calendar` | Full read and write access to calendars | +| Calendar: Read Only | `https://www.googleapis.com/auth/calendar.readonly` | View calendars | +| Calendar: Manage Events | `https://www.googleapis.com/auth/calendar.events` | View and edit events on all calendars | +| Calendar: View Events | `https://www.googleapis.com/auth/calendar.events.readonly` | View events on all calendars | + +### Google Drive + +| Scope label | Scope value | Description | +|---|---|---| +| Drive: Full Access | `https://www.googleapis.com/auth/drive` | Full read and write access to all Drive files | +| Drive: Read Only | `https://www.googleapis.com/auth/drive.readonly` | View files in Drive | +| Drive: Access Files Created by This App | `https://www.googleapis.com/auth/drive.file` | Access only files created or opened by this app | +| Drive: App Data Folder | `https://www.googleapis.com/auth/drive.appdata` | Access the app-specific data folder | +| Drive: Manage Metadata | `https://www.googleapis.com/auth/drive.metadata` | View and manage metadata of files | +| Drive: View Metadata | `https://www.googleapis.com/auth/drive.metadata.readonly` | View metadata of files | + +### Google Docs + +| Scope label | Scope value | Description | +|---|---|---| +| Docs: Full Access | `https://www.googleapis.com/auth/documents` | View and manage Google Docs documents | +| Docs: Read Only | `https://www.googleapis.com/auth/documents.readonly` | View Google Docs documents | + +### Google Sheets + +| Scope label | Scope value | Description | +|---|---|---| +| Sheets: Full Access | `https://www.googleapis.com/auth/spreadsheets` | View and manage Google Sheets spreadsheets | +| Sheets: Read Only | `https://www.googleapis.com/auth/spreadsheets.readonly` | View Google Sheets spreadsheets | + +### Google Forms + +| Scope label | Scope value | Description | +|---|---|---| +| Forms: Create and Edit Forms | `https://www.googleapis.com/auth/forms.body` | View and manage form definitions | +| Forms: View Forms | `https://www.googleapis.com/auth/forms.body.readonly` | View form definitions | +| Forms: View Responses | `https://www.googleapis.com/auth/forms.responses.readonly` | View form responses | + +### Google Chat + +| Scope label | Scope value | Description | +|---|---|---| +| Chat: View, Compose, and Delete Messages | `https://www.googleapis.com/auth/chat.messages` | View, create, update, and delete messages | +| Chat: Compose and Send Messages | `https://www.googleapis.com/auth/chat.messages.create` | Create and send messages in spaces | +| Chat: View Messages | `https://www.googleapis.com/auth/chat.messages.readonly` | View messages and reactions | +| Chat: Manage Spaces | `https://www.googleapis.com/auth/chat.spaces` | Create, view, update, and delete spaces | +| Chat: Create Spaces | `https://www.googleapis.com/auth/chat.spaces.create` | Create spaces | +| Chat: View Spaces | `https://www.googleapis.com/auth/chat.spaces.readonly` | View spaces | + +### User identity + +| Scope label | Scope value | Description | +|---|---|---| +| User Info: Email Address | `https://www.googleapis.com/auth/userinfo.email` | View the user's email address | +| User Info: Basic Profile | `https://www.googleapis.com/auth/userinfo.profile` | View the user's basic profile info | +| OpenID Connect | `openid` | Authenticate using OpenID Connect | + +### Google Workspace Admin + +| Scope label | Scope value | Description | +|---|---|---| +| Admin: Manage Users | `https://www.googleapis.com/auth/admin.directory.user` | Create, read, update, and delete users | +| Admin: View Users | `https://www.googleapis.com/auth/admin.directory.user.readonly` | View users in the directory | +| Admin: Manage Groups | `https://www.googleapis.com/auth/admin.directory.group` | Create, read, update, and delete groups | +| Admin: View Groups | `https://www.googleapis.com/auth/admin.directory.group.readonly` | View groups in the directory | + +## Further reading + +{{< partial name="whats-next/whats-next.html" >}} + +
Do you have questions or feedback? Join the **#workflows** or **#app-builder** channel on the [Datadog Community Slack][4]. + +[1]: https://console.cloud.google.com/ +[2]: https://app.datadoghq.com/workflow +[3]: https://app.datadoghq.com/app-builder +[4]: https://chat.datadoghq.com/ From 4235d1cc23a7d917963677627089d89891d92f6a Mon Sep 17 00:00:00 2001 From: maddiefranke Date: Thu, 23 Apr 2026 21:03:43 +0000 Subject: [PATCH 2/7] Add Authorized JavaScript origins step and hyperlink navigation steps Co-Authored-By: Claude Sonnet 4.6 --- content/en/actions/connections/google_workspace.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/content/en/actions/connections/google_workspace.md b/content/en/actions/connections/google_workspace.md index e0a4292341b..897a1120d8e 100644 --- a/content/en/actions/connections/google_workspace.md +++ b/content/en/actions/connections/google_workspace.md @@ -26,7 +26,7 @@ If you don't already have a Google Cloud project: Enable the Google APIs you plan to use in your workflows: -1. In the Google Cloud Console, navigate to **APIs & Services** > **Library**. +1. Navigate to [**APIs & Services** > **Library**][5] in the Google Cloud Console. 1. Search for and enable the APIs for the Google Workspace services you intend to use: | Google Workspace service | API to enable | @@ -41,7 +41,7 @@ Enable the Google APIs you plan to use in your workflows: ### 3. Configure the OAuth consent screen -1. In the Google Cloud Console, navigate to **APIs & Services** > **OAuth consent screen**. +1. Navigate to [**APIs & Services** > **OAuth consent screen**][6] in the Google Cloud Console. 1. Select a user type: - **Internal**: Limits access to users in your Google Workspace organization. Recommended for most enterprise use cases. - **External**: Allows any Google account to authorize. Requires app verification for production use. @@ -51,10 +51,11 @@ Enable the Google APIs you plan to use in your workflows: ### 4. Create OAuth2 credentials -1. In the Google Cloud Console, navigate to **APIs & Services** > **Credentials**. +1. Navigate to [**APIs & Services** > **Credentials**][7] in the Google Cloud Console. 1. Click **Create Credentials** > **OAuth client ID**. 1. For **Application type**, select **Web application**. -1. Under **Authorized redirect URIs**, add the Datadog OAuth callback URL. This URL is displayed in the Datadog connection creation dialog when you select **Google Workspace**. +1. Under **Authorized JavaScript origins**, add the Datadog origin URL. This URL is displayed in the Datadog connection creation dialog when you select **Google Workspace**. +1. Under **Authorized redirect URIs**, add the Datadog OAuth callback URL. This URL is also displayed in the Datadog connection creation dialog when you select **Google Workspace**. 1. Click **Create**. 1. Copy the **Client ID** and **Client Secret** — you need these when creating the connection in Datadog. @@ -166,3 +167,6 @@ Select only the scopes required by the actions you intend to use. [2]: https://app.datadoghq.com/workflow [3]: https://app.datadoghq.com/app-builder [4]: https://chat.datadoghq.com/ +[5]: https://console.cloud.google.com/apis/library +[6]: https://console.cloud.google.com/apis/credentials/consent +[7]: https://console.cloud.google.com/apis/credentials From a2ce1f88f9eb4f61a07ffe2be4a915aa37b88f66 Mon Sep 17 00:00:00 2001 From: maddiefranke Date: Thu, 23 Apr 2026 21:50:46 +0000 Subject: [PATCH 3/7] Update connection steps to reference Action Catalog page Co-Authored-By: Claude Sonnet 4.6 --- content/en/actions/connections/google_workspace.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/content/en/actions/connections/google_workspace.md b/content/en/actions/connections/google_workspace.md index 897a1120d8e..2950000aa88 100644 --- a/content/en/actions/connections/google_workspace.md +++ b/content/en/actions/connections/google_workspace.md @@ -61,7 +61,7 @@ Enable the Google APIs you plan to use in your workflows: ## Create the connection in Datadog -1. From the [Workflow Automation page][2] or the [App Builder page][3], click the **Connections** tab. +1. From the [Action Catalog page][2], click the **Connections** tab. 1. Click **New Connection**. 1. Select the **Google Workspace** icon. 1. Enter a **Connection Name**. @@ -164,8 +164,7 @@ Select only the scopes required by the actions you intend to use.
Do you have questions or feedback? Join the **#workflows** or **#app-builder** channel on the [Datadog Community Slack][4]. [1]: https://console.cloud.google.com/ -[2]: https://app.datadoghq.com/workflow -[3]: https://app.datadoghq.com/app-builder +[2]: https://app.datadoghq.com/actions/action-catalog [4]: https://chat.datadoghq.com/ [5]: https://console.cloud.google.com/apis/library [6]: https://console.cloud.google.com/apis/credentials/consent From b1c1e2e182fa9d60e9ed9e14b19ef9db97ca6a98 Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Wed, 29 Apr 2026 10:15:42 -0400 Subject: [PATCH 4/7] Apply editorial review feedback to Google Workspace connection doc - Use the {{< ui >}}{{< /ui >}} shortcode for Datadog UI labels for consistency with other connection docs - Renumber reference links sequentially (skipped [3] previously) - Remove numerals from prerequisite subheadings to produce cleaner anchors - Rephrase step 2 of "Enable the required APIs" so the table reads as part of the procedure - Drop redundant "below" after in-page anchor links - Replace "info" with "information" in the User identity scopes table - Reword "Google Docs documents" and "Google Sheets spreadsheets" to remove noun stacking --- .../actions/connections/google_workspace.md | 56 +++++++++---------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/content/en/actions/connections/google_workspace.md b/content/en/actions/connections/google_workspace.md index 2950000aa88..9ce0cc01898 100644 --- a/content/en/actions/connections/google_workspace.md +++ b/content/en/actions/connections/google_workspace.md @@ -14,7 +14,7 @@ Use a Google Workspace connection to authenticate Datadog Actions against Google Before creating the connection in Datadog, you must set up an OAuth2 client in Google Cloud. -### 1. Create a Google Cloud project +### Create a Google Cloud project If you don't already have a Google Cloud project: @@ -22,12 +22,12 @@ If you don't already have a Google Cloud project: 1. Click **Select a project** > **New Project**. 1. Enter a project name and click **Create**. -### 2. Enable the required APIs +### Enable the required APIs Enable the Google APIs you plan to use in your workflows: -1. Navigate to [**APIs & Services** > **Library**][5] in the Google Cloud Console. -1. Search for and enable the APIs for the Google Workspace services you intend to use: +1. Navigate to [**APIs & Services** > **Library**][3] in the Google Cloud Console. +1. Search for and enable the APIs for the Google Workspace services you intend to use, listed in the following table. | Google Workspace service | API to enable | |---|---| @@ -39,36 +39,36 @@ Enable the Google APIs you plan to use in your workflows: | Google Forms | Google Forms API | | Google Chat | Google Chat API | -### 3. Configure the OAuth consent screen +### Configure the OAuth consent screen -1. Navigate to [**APIs & Services** > **OAuth consent screen**][6] in the Google Cloud Console. +1. Navigate to [**APIs & Services** > **OAuth consent screen**][4] in the Google Cloud Console. 1. Select a user type: - **Internal**: Limits access to users in your Google Workspace organization. Recommended for most enterprise use cases. - **External**: Allows any Google account to authorize. Requires app verification for production use. 1. Fill in the required app information fields and click **Save and Continue**. -1. Under **Scopes**, add the OAuth scopes required for the actions you intend to use. See the [scopes reference](#scopes-reference) below. +1. Under **Scopes**, add the OAuth scopes required for the actions you intend to use. See the [scopes reference](#scopes-reference). 1. Complete the remaining steps and click **Back to Dashboard**. -### 4. Create OAuth2 credentials +### Create OAuth2 credentials -1. Navigate to [**APIs & Services** > **Credentials**][7] in the Google Cloud Console. +1. Navigate to [**APIs & Services** > **Credentials**][5] in the Google Cloud Console. 1. Click **Create Credentials** > **OAuth client ID**. 1. For **Application type**, select **Web application**. 1. Under **Authorized JavaScript origins**, add the Datadog origin URL. This URL is displayed in the Datadog connection creation dialog when you select **Google Workspace**. 1. Under **Authorized redirect URIs**, add the Datadog OAuth callback URL. This URL is also displayed in the Datadog connection creation dialog when you select **Google Workspace**. 1. Click **Create**. -1. Copy the **Client ID** and **Client Secret** — you need these when creating the connection in Datadog. +1. Copy the **Client ID** and **Client Secret**—you need these when creating the connection in Datadog. ## Create the connection in Datadog -1. From the [Action Catalog page][2], click the **Connections** tab. -1. Click **New Connection**. -1. Select the **Google Workspace** icon. -1. Enter a **Connection Name**. -1. Enter the **Client ID** and **Client Secret** from your Google Cloud OAuth2 credentials. -1. Select the **Scopes** required for the actions you plan to use. See the [scopes reference](#scopes-reference) below. -1. The **Authorize URL** and **Token URL** fields are pre-populated with Google's default OAuth2 endpoints. Leave these as-is unless you have a specific reason to change them. -1. Click **Create**. +1. From the [Action Catalog page][2], click the {{< ui >}}Connections{{< /ui >}} tab. +1. Click {{< ui >}}New Connection{{< /ui >}}. +1. Select the {{< ui >}}Google Workspace{{< /ui >}} icon. +1. Enter a {{< ui >}}Connection Name{{< /ui >}}. +1. Enter the {{< ui >}}Client ID{{< /ui >}} and {{< ui >}}Client Secret{{< /ui >}} from your Google Cloud OAuth2 credentials. +1. Select the {{< ui >}}Scopes{{< /ui >}} required for the actions you plan to use. See the [scopes reference](#scopes-reference). +1. The {{< ui >}}Authorize URL{{< /ui >}} and {{< ui >}}Token URL{{< /ui >}} fields are pre-populated with Google's default OAuth2 endpoints. Leave these as-is unless you have a specific reason to change them. +1. Click {{< ui >}}Create{{< /ui >}}. 1. In the authorization window that opens, sign in with the Google account you want to use and grant the requested permissions. ## Scopes reference @@ -111,15 +111,15 @@ Select only the scopes required by the actions you intend to use. | Scope label | Scope value | Description | |---|---|---| -| Docs: Full Access | `https://www.googleapis.com/auth/documents` | View and manage Google Docs documents | -| Docs: Read Only | `https://www.googleapis.com/auth/documents.readonly` | View Google Docs documents | +| Docs: Full Access | `https://www.googleapis.com/auth/documents` | View and manage documents in Google Docs | +| Docs: Read Only | `https://www.googleapis.com/auth/documents.readonly` | View documents in Google Docs | ### Google Sheets | Scope label | Scope value | Description | |---|---|---| -| Sheets: Full Access | `https://www.googleapis.com/auth/spreadsheets` | View and manage Google Sheets spreadsheets | -| Sheets: Read Only | `https://www.googleapis.com/auth/spreadsheets.readonly` | View Google Sheets spreadsheets | +| Sheets: Full Access | `https://www.googleapis.com/auth/spreadsheets` | View and manage spreadsheets in Google Sheets | +| Sheets: Read Only | `https://www.googleapis.com/auth/spreadsheets.readonly` | View spreadsheets in Google Sheets | ### Google Forms @@ -145,7 +145,7 @@ Select only the scopes required by the actions you intend to use. | Scope label | Scope value | Description | |---|---|---| | User Info: Email Address | `https://www.googleapis.com/auth/userinfo.email` | View the user's email address | -| User Info: Basic Profile | `https://www.googleapis.com/auth/userinfo.profile` | View the user's basic profile info | +| User Info: Basic Profile | `https://www.googleapis.com/auth/userinfo.profile` | View the user's basic profile information | | OpenID Connect | `openid` | Authenticate using OpenID Connect | ### Google Workspace Admin @@ -161,11 +161,11 @@ Select only the scopes required by the actions you intend to use. {{< partial name="whats-next/whats-next.html" >}} -
Do you have questions or feedback? Join the **#workflows** or **#app-builder** channel on the [Datadog Community Slack][4]. +
Do you have questions or feedback? Join the **#workflows** or **#app-builder** channel on the [Datadog Community Slack][6]. [1]: https://console.cloud.google.com/ [2]: https://app.datadoghq.com/actions/action-catalog -[4]: https://chat.datadoghq.com/ -[5]: https://console.cloud.google.com/apis/library -[6]: https://console.cloud.google.com/apis/credentials/consent -[7]: https://console.cloud.google.com/apis/credentials +[3]: https://console.cloud.google.com/apis/library +[4]: https://console.cloud.google.com/apis/credentials/consent +[5]: https://console.cloud.google.com/apis/credentials +[6]: https://chat.datadoghq.com/ From 7fde3d58bd89cdfe3c64c4a0a9a1f3a243d50db4 Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Wed, 29 Apr 2026 10:34:18 -0400 Subject: [PATCH 5/7] Update to OAuth 2.0 --- content/en/actions/connections/google_workspace.md | 10 +++++----- content/en/actions/connections/http.md | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/en/actions/connections/google_workspace.md b/content/en/actions/connections/google_workspace.md index 9ce0cc01898..a3d86cb1b3f 100644 --- a/content/en/actions/connections/google_workspace.md +++ b/content/en/actions/connections/google_workspace.md @@ -1,6 +1,6 @@ --- title: Google Workspace -description: Connect Datadog Actions to Google Workspace services using OAuth2 to automate tasks in Gmail, Calendar, Drive, Docs, Sheets, Forms, and Chat. +description: Connect Datadog Actions to Google Workspace services using OAuth 2.0 to automate tasks in Gmail, Calendar, Drive, Docs, Sheets, Forms, and Chat. disable_toc: false further_reading: - link: "/actions/connections/" @@ -12,7 +12,7 @@ Use a Google Workspace connection to authenticate Datadog Actions against Google ## Prerequisites -Before creating the connection in Datadog, you must set up an OAuth2 client in Google Cloud. +Before creating the connection in Datadog, you must set up an OAuth 2.0 client in Google Cloud. ### Create a Google Cloud project @@ -49,7 +49,7 @@ Enable the Google APIs you plan to use in your workflows: 1. Under **Scopes**, add the OAuth scopes required for the actions you intend to use. See the [scopes reference](#scopes-reference). 1. Complete the remaining steps and click **Back to Dashboard**. -### Create OAuth2 credentials +### Create OAuth 2.0 credentials 1. Navigate to [**APIs & Services** > **Credentials**][5] in the Google Cloud Console. 1. Click **Create Credentials** > **OAuth client ID**. @@ -65,9 +65,9 @@ Enable the Google APIs you plan to use in your workflows: 1. Click {{< ui >}}New Connection{{< /ui >}}. 1. Select the {{< ui >}}Google Workspace{{< /ui >}} icon. 1. Enter a {{< ui >}}Connection Name{{< /ui >}}. -1. Enter the {{< ui >}}Client ID{{< /ui >}} and {{< ui >}}Client Secret{{< /ui >}} from your Google Cloud OAuth2 credentials. +1. Enter the {{< ui >}}Client ID{{< /ui >}} and {{< ui >}}Client Secret{{< /ui >}} from your Google Cloud OAuth 2.0 credentials. 1. Select the {{< ui >}}Scopes{{< /ui >}} required for the actions you plan to use. See the [scopes reference](#scopes-reference). -1. The {{< ui >}}Authorize URL{{< /ui >}} and {{< ui >}}Token URL{{< /ui >}} fields are pre-populated with Google's default OAuth2 endpoints. Leave these as-is unless you have a specific reason to change them. +1. The {{< ui >}}Authorize URL{{< /ui >}} and {{< ui >}}Token URL{{< /ui >}} fields are pre-populated with Google's default OAuth 2.0 endpoints. Leave these as-is unless you have a specific reason to change them. 1. Click {{< ui >}}Create{{< /ui >}}. 1. In the authorization window that opens, sign in with the Google account you want to use and grant the requested permissions. diff --git a/content/en/actions/connections/http.md b/content/en/actions/connections/http.md index 16c751f1d34..9840b45084d 100644 --- a/content/en/actions/connections/http.md +++ b/content/en/actions/connections/http.md @@ -52,7 +52,7 @@ If you need to authenticate your request, use the action's {{< ui >}}Connection{ 1. In the {{< ui >}}Connection{{< /ui >}} section, click the plus icon ({{< ui >}}+{{< /ui >}}). 1. Select {{< ui >}}Azure{{< /ui >}}. 1. Enter a {{< ui >}}Connection Name{{< /ui >}}, {{< ui >}}Tenant ID{{< /ui >}}, {{< ui >}}Client ID{{< /ui >}}, and {{< ui >}}Client Secret{{< /ui >}}. -1. Optionally, enter the {{< ui >}}Custom Scope{{< /ui >}} to be requested from Microsoft when acquiring an OAuth 2 access token. A resource's scope is constructed using the identifier URI for the resource and `.default`, separated by a forward slash (`/`). For example, `{identifierURI}/.default`. For more information, see [the Microsoft documentation on .default scope][3]. +1. Optionally, enter the {{< ui >}}Custom Scope{{< /ui >}} to be requested from Microsoft when acquiring an OAuth 2.0 access token. A resource's scope is constructed using the identifier URI for the resource and `.default`, separated by a forward slash (`/`). For example, `{identifierURI}/.default`. For more information, see [the Microsoft documentation on .default scope][3]. 1. Click {{< ui >}}Create{{< /ui >}}. ### Create an HTTP token authentication connection From c440697e752827d8dfdf0a6a119542a92b1984c2 Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Wed, 29 Apr 2026 14:02:37 -0400 Subject: [PATCH 6/7] Add to left nav --- config/_default/menus/main.en.yaml | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index 1d8c011a4ca..cc3a43c047c 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -2956,7 +2956,12 @@ menu: url: actions/connections/aws_integration/ parent: actions_connections identifier: actions_aws_integration - weight: 101 + weight: 102 + - name: Google Workspace + url: actions/connections/google_workspace/ + parent: actions_connections + identifier: actions_google_workspace + weight: 103 - name: Private Actions url: actions/private_actions/ parent: action_catalog From bddf8e45d490196aa1a555233a3b094bfef26035 Mon Sep 17 00:00:00 2001 From: Maddie Franke Date: Thu, 30 Apr 2026 15:35:20 -0400 Subject: [PATCH 7/7] Address PR review feedback - Reword Prerequisites intro and replace inline Google Cloud project creation steps with a link to Google's own guide. - Link "app verification" to Google's restricted-scope verification doc and clarify "authorize" -> "authorize the app". - Combine the Authorized JavaScript origins and Authorized redirect URIs steps into a single instruction with a shared note. - Reword the Authorize URL/Token URL step to "Leave [...] as their pre-populated default values". - Renumber reference-style links in usage order and drop the now-unused Google Cloud Console root link. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../actions/connections/google_workspace.md | 38 ++++++++----------- 1 file changed, 15 insertions(+), 23 deletions(-) diff --git a/content/en/actions/connections/google_workspace.md b/content/en/actions/connections/google_workspace.md index a3d86cb1b3f..17f180188ae 100644 --- a/content/en/actions/connections/google_workspace.md +++ b/content/en/actions/connections/google_workspace.md @@ -12,21 +12,13 @@ Use a Google Workspace connection to authenticate Datadog Actions against Google ## Prerequisites -Before creating the connection in Datadog, you must set up an OAuth 2.0 client in Google Cloud. - -### Create a Google Cloud project - -If you don't already have a Google Cloud project: - -1. Go to the [Google Cloud Console][1]. -1. Click **Select a project** > **New Project**. -1. Enter a project name and click **Create**. +You must have an OAuth 2.0 client in Google Cloud to create a connection in Datadog. If you don't already have a Google Cloud project, follow Google's [Create a Google Cloud project][1] guide. ### Enable the required APIs -Enable the Google APIs you plan to use in your workflows: +Enable the Google APIs you plan to use in your workflows and apps: -1. Navigate to [**APIs & Services** > **Library**][3] in the Google Cloud Console. +1. Navigate to [**APIs & Services** > **Library**][2] in the Google Cloud Console. 1. Search for and enable the APIs for the Google Workspace services you intend to use, listed in the following table. | Google Workspace service | API to enable | @@ -41,10 +33,10 @@ Enable the Google APIs you plan to use in your workflows: ### Configure the OAuth consent screen -1. Navigate to [**APIs & Services** > **OAuth consent screen**][4] in the Google Cloud Console. +1. Navigate to [**APIs & Services** > **OAuth consent screen**][3] in the Google Cloud Console. 1. Select a user type: - **Internal**: Limits access to users in your Google Workspace organization. Recommended for most enterprise use cases. - - **External**: Allows any Google account to authorize. Requires app verification for production use. + - **External**: Allows any Google account to authorize the app. Requires [app verification][4] for production use. 1. Fill in the required app information fields and click **Save and Continue**. 1. Under **Scopes**, add the OAuth scopes required for the actions you intend to use. See the [scopes reference](#scopes-reference). 1. Complete the remaining steps and click **Back to Dashboard**. @@ -54,20 +46,19 @@ Enable the Google APIs you plan to use in your workflows: 1. Navigate to [**APIs & Services** > **Credentials**][5] in the Google Cloud Console. 1. Click **Create Credentials** > **OAuth client ID**. 1. For **Application type**, select **Web application**. -1. Under **Authorized JavaScript origins**, add the Datadog origin URL. This URL is displayed in the Datadog connection creation dialog when you select **Google Workspace**. -1. Under **Authorized redirect URIs**, add the Datadog OAuth callback URL. This URL is also displayed in the Datadog connection creation dialog when you select **Google Workspace**. +1. Under **Authorized JavaScript origins**, add the Datadog origin URL. Under **Authorized redirect URIs**, add the Datadog OAuth callback URL. Both URLs are displayed in the Datadog connection creation dialog when you select **Google Workspace**. 1. Click **Create**. 1. Copy the **Client ID** and **Client Secret**—you need these when creating the connection in Datadog. ## Create the connection in Datadog -1. From the [Action Catalog page][2], click the {{< ui >}}Connections{{< /ui >}} tab. +1. From the [Action Catalog page][6], click the {{< ui >}}Connections{{< /ui >}} tab. 1. Click {{< ui >}}New Connection{{< /ui >}}. 1. Select the {{< ui >}}Google Workspace{{< /ui >}} icon. 1. Enter a {{< ui >}}Connection Name{{< /ui >}}. 1. Enter the {{< ui >}}Client ID{{< /ui >}} and {{< ui >}}Client Secret{{< /ui >}} from your Google Cloud OAuth 2.0 credentials. 1. Select the {{< ui >}}Scopes{{< /ui >}} required for the actions you plan to use. See the [scopes reference](#scopes-reference). -1. The {{< ui >}}Authorize URL{{< /ui >}} and {{< ui >}}Token URL{{< /ui >}} fields are pre-populated with Google's default OAuth 2.0 endpoints. Leave these as-is unless you have a specific reason to change them. +1. Leave the {{< ui >}}Authorize URL{{< /ui >}} and {{< ui >}}Token URL{{< /ui >}} fields as their pre-populated default values unless you have a specific reason to change them. 1. Click {{< ui >}}Create{{< /ui >}}. 1. In the authorization window that opens, sign in with the Google account you want to use and grant the requested permissions. @@ -161,11 +152,12 @@ Select only the scopes required by the actions you intend to use. {{< partial name="whats-next/whats-next.html" >}} -
Do you have questions or feedback? Join the **#workflows** or **#app-builder** channel on the [Datadog Community Slack][6]. +
Do you have questions or feedback? Join the **#workflows** or **#app-builder** channel on the [Datadog Community Slack][7]. -[1]: https://console.cloud.google.com/ -[2]: https://app.datadoghq.com/actions/action-catalog -[3]: https://console.cloud.google.com/apis/library -[4]: https://console.cloud.google.com/apis/credentials/consent +[1]: https://developers.google.com/workspace/guides/create-project +[2]: https://console.cloud.google.com/apis/library +[3]: https://console.cloud.google.com/apis/credentials/consent +[4]: https://developers.google.com/identity/protocols/oauth2/production-readiness/restricted-scope-verification [5]: https://console.cloud.google.com/apis/credentials -[6]: https://chat.datadoghq.com/ +[6]: https://app.datadoghq.com/actions/action-catalog +[7]: https://chat.datadoghq.com/