Skip to main content

Google Workspace agents

Enables users to search for files, emails, calendar events, and chat spaces from Google Workspace.

Create an OAuth application in Google Workspace​

  1. Refer to Google's documentation to create a new OAuth 2.0 client in Google Workspace:

    • For Application type, select "Web Application".

    • Under Authorized redirect URIs, add {ORG_ORIGIN}/agent/google/response (replace {ORG_ORIGIN} with the correct origin for the org, e.g. https://{ORG_NAME}.is.here.io).

  2. Once created, copy the client ID and secret values for the OAuth 2.0 client, as they will be used in later steps.

  3. Go to the "Data Access" section and add the following scopes:

    • https://www.googleapis.com/auth/calendar.readonly
    • https://www.googleapis.com/auth/drive.readonly
    • https://www.googleapis.com/auth/gmail.readonly
    • https://www.googleapis.com/auth/spreadsheets.readonly
    • https://www.googleapis.com/auth/userinfo.profile
    • https://www.googleapis.com/auth/chat.spaces.readonly

  4. Enable the following APIs in the API library:

    • Gmail API
    • Google Calendar API
    • Google Docs API
    • Google Drive API
    • Google Sheets API
    • Google Chat API
info

For the Chat API, go to its Manage page and under Configuration, fill out the three required fields (their value does not matter; you may use placeholder values, such as https://placehold.co/256 for the avatar URL). Click Save and ensure "App status" at the top says LIVE - available to users.

Add the agent in Admin Console​

If this agent is enabled for your Enterprise Browser Instance (it can be enabled upon request), follow these steps:

  1. In the Admin Console, navigate to the Content page. Click Create and then Agent.

  2. Select Google Workspace.

  3. Add a Description or keep the default one provided. Then add the Client ID and Client Secret provided by Google Workspace in the previous section.

  4. Click the Grant Access button. Choose which users or groups need access to the agent.

  5. Click the Create Agent button. The agent is added to the Content page, but not yet activated.

  6. To activate the agent, click the Action ⋮ menu on the agent and select Activate.

Table of Contents