---
title: "Example: OAuth Configuration for Google Docs"
slug: "example-oauth-configuration-for-google-docs"
updated: 2026-05-29T16:53:33Z
published: 2026-05-29T16:53:33Z
canonical: "docs.algosolutions.com/example-oauth-configuration-for-google-docs"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.algosolutions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Example: OAuth Configuration for Google Docs

This guide explains how to:

- Integrate an Algo device with Google Docs using OAuth
- Verify the configuration by creating a test file in Google Drive
- Use the OAuth profile to create a test file in Google Drive from an Algo 8450

> [!NOTE]
> Note
> 
> This document includes third-party configuration procedures that are subject to change. It is provided for reference purposes only, and Algo cannot guarantee that the screenshots or procedures will always be current or up to date.

### **Before you start**

Ensure you have a Google account that is connected to Google Drive

### Procedure Overview

This procedure includes the following steps:

1. [Creating a Google Cloud OAuth Project](/docs/example-oauth-configuration-for-google-docs#creating-a-google-cloud-oauth-project)
2. [Creating an OAuth Authorization Profile](/docs/example-oauth-configuration-for-google-docs#creating-an-oauth-authorization-profile)
3. [Creating a Test Document](/docs/example-oauth-configuration-for-google-docs#creating-a-test-document)
4. (Optional): [Configuring an 8450 Button to Create a Google Drive File](/docs/example-oauth-configuration-for-google-docs#configuring-an-8450-button-to-create-a-google-drive-file)

---

### Creating a Google Cloud OAuth Project

Create a Google Cloud OAuth project and obtain the required credentials for OAuth.

1. Sign in to the [**Google Cloud Console**](https://console.cloud.google.com/).
2. Click **Select a project**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-08 103834 (1) (1) (1).png)
3. Select **New project**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-08 104004 (1)(1) (1).png)
4. Enter a name for your project, then select **Create**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 132034 (1).png)
5. In the notification window, click **Select Project**below your project name.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 132224 (1).png)
6. Select **APIs & Services** → **Enabled APIs & services**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 133602 (2).png)
7. Select **Enable APIs and services** from the navigation menu.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 134927 (1).png)
8. Search **Google Drive API** to locate it.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/image(849).png)
9. Select **Google Drive API**

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-08 110527 (1).png)
10. Select **Enable**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-08 110929 (1).png)
11. Select **Credentials**→**+ Create credentials**→ **OAuth client ID**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-08 111510 (2).png)
12. Select **Configure consent screen**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-08 111736 (1).png)
13. Select **Get started**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-08 112311 (1).png)
14. Follow the on-screen instructions to configure your project, then select **Create**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-08 112815 (1).png)
  - **App Information**
    - **App name:** Enter a name for your application.
    - **User support email**: Enter an email for users to contact you with questions about their consent.
  - **Audience**: Set to **External**.

This makes the application available to any test user with a Google Account.
  - **Contact Information**: Enter your email for Google to notify you about any changes to this project.
  - **Finish**: Accept the **Google API services user data policy**.
15. Select **Create OAuth client**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-08 113111 (1).png)
16. Configure the following, then select **Create**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 145422 (1)(1).png)
  - **Application type**: Set to **TVs and Limited Input devices**.
  - **Name**: Enter a name.
17. Copy the **Client ID**and **Client secret**.

You need this information to configure OAuth later.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 145941 (1).png)
18. Go to **Audience**→ **+ Add users**.

Add your Google account as a test user to access the project.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 150627 (1).png)
19. Enter the same email you used to sign in to [**Google Cloud Console**](https://console.cloud.google.com/). Then select **Save**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 150825 (1).png)

### Creating an OAuth Authorization Profile

Create an OAuth profile to store your Google Docs authentication settings.

Ensure you have the following:

- **Client ID**
- **Client Secret**

**To create a Google Docs OAuth Profile:**

1. Log in to your device’s web interface using HTTPS.

HTTPS is required by the Google Docs OAuth process.
2. Go to the **Advanced Settings** → **OAuth**.
3. Set a **Name**for your OAuth profile.
4. Select **GOOGLE_DOCS**as the **Provider Type.**
5. Accept the following automatically populated values:
  - **Grant Type**: DEVICE_CODE
  - **Token URL**: [https://oauth2.googleapis.com/token](https://oauth2.googleapis.com/token)
  - **Auth URL**:****[https://oauth2.googleapis.com/device/code](https://oauth2.googleapis.com/device/code)
  - **Client Auth Mode**: CLIENT_SECRET_POST
  - **Scope Mode**: SCOPES_LIST
  - **Scope**: [https://www.googleapis.com/auth/drive.file](https://www.googleapis.com/auth/drive.file)
  - **Extra Params (JSON)**:

```bash
{
  "access_type": "offline",
  "include_granted_scopes": true,
  "prompt": "consent",
  "jwks_uri": "https://www.googleapis.com/oauth2/v3/certs",
  "revocation_endpoint": "https://oauth2.googleapis.com/revoke",
  "device_authorization_endpoint": "https://oauth2.googleapis.com/device/code",
  "issuer": "https://accounts.google.com"
}
```
    1. 
6. Set the following:
  - **Client ID**: Enter your OAuth**Client ID**.
  - **Client Secret**: Enter your **OAuth****Client Secret**.
7. Select **START AUTHORIZATION**.
8. Copy the**User code** that appears on the right of the **START AUTHORIZATION**button.

You need this code to connect your device to Google Docs.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 155211 (1).png)
9. Go to [https://www.google.com/device](https://www.google.com/device).
10. Enter your user code and select **Continue**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/image(860).png)
11. Select your Google account.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 155934 (1).png)
12. Select **Continue**to verify the application.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/image(857) (1).png)
13. Select **Continue**.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-09 160311 (1).png)

Upon success, the following screen appears:

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/image(859).png)
14. Go back to your Algo device’s web interface and select **Create Profile**.****

Your profile appears under the **OAuth Profiles** list.

### Creating a Test Document

You can create a test meeting to verify that the configuration is working correctly.

**To create a file in Google Drive:**

1. Log in to your device’s web interface using HTTPS.

HTTPS is required by Google Docs OAuth process.
2. Go to the **Advanced Settings** → **OAuth**.
3. Select your **Google Docs**profile from the **Test OAuth Profile** dropdown list.
4. Select **GOOGLE_DOCS**as the **Provider Type Template.**
5. Accept the following default settings:
  - **Target URL and Path**: [https://www.googleapis.com/drive/v3/files](https://www.googleapis.com/drive/v3/files).
  - **Custom Header**:

```plaintext
Content-Type: application/json; charset=utf-8
```
  - **Data Payload.**

```plaintext
{
  "name": "oauth-test.txt",
  "mimeType": "text/plain"
}
```
6. Select **RUN OAuth Test**.

Upon success:
  - The document **oauth-test.txt** appears in your Google Drive’s **My Drive**section.

  

A successful response is displayed.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-10 103508 (1).png)

### Configuring an 8450 Button to Create a Google Drive File

You can configure a button on the Algo 8450 to create a Google Drive file.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/image(866).png)

**To configure an 8450 button to create a Google Docs meeting:**

1. Create a button on an 8450 screen.
2. Set the **Button Status** to **Enabled.**
3. Configure the following:
  - **Text**: Enter the button display text.
  - **Action**: Set to **Send API Request**.
  - **Number of API Requests**: Set to **1**.
  - **Request 1 - Command**: Set to **Other**.
  - **Request 1 - Method**: Set to **POST**.
  - **Request 1 - Custom Path**: Set to `upload/drive/v3/files`.
  - **Request 1 - Targets**: Set to `www.googleapis.com`.
  - **Request 1 - OAuth Profile**: Select your Google Docs profile.
  - **Request 1 - Headers**: Set to **Custom Headers**.
  - **Request 1 - Custom Headers**: Set to `Content-Type: application/json; charset=utf-8`.
  - **Request 1 - Data Payload**:

```plaintext
Hello
```
4. **Select Save.**

Press the button and verify that the file is created in your Google Docs’ **My Drive** section.

#### Troubleshooting

**I get a 502 error when I run the OAuth Test**

You may be logged out of the device’s web interface. Log in again and retry.

**After I run the “Start Authorization” again, my OAuth Test fails**

Each time you run **Start Authorization** again, select **Update Profile** to save the new credentials before running the test.

![](https://cdn.document360.io/f6f5e62d-d280-487f-9da7-5926ffd53b5f/Images/Documentation/Screenshot 2026-04-06 151132 (1).png)

**My OAuth profile stops working.**

An OAuth profile can stop working if the OAuth provider rejects or invalidates the access or refresh token. Refer to the OAuth provider’s documentation for more information. If this occurs, the OAuth profile must be reauthorized.