This article only applies to your community if your Firstup contract includes this functionality. Please contact your Customer Success Manager with any questions about feature availability for your community.
The Google Search integration lets you search for Google Drive content, including supported Google Sites, from your Firstup web or mobile experience. Your results depend on your connected Google account’s permissions and any source restrictions configured for your community.
Use this guide to configure your Google app, coordinate setup with Firstup, and connect your account.
Before You Start
- Work with your Google Workspace administrator to complete the Google configuration.
- Contact your Firstup representative to confirm your community’s hosting region: US1, US2, or EU.
- Choose whether to create your own internal Google app or use Firstup’s Google app.
- If you create your own app, make sure you can create a Google Cloud project within your organization and manage its OAuth settings.
Configuration Scope
You can configure the integration in either of the following ways:
| Option | What you do | What Firstup does |
|---|---|---|
| Your own Google app | Create an internal app in your Google Workspace organization and provide its OAuth client ID and client secret to Firstup. | Configure the integration with your credentials and enable Google Drive search for your community. |
| Firstup’s Google app | Approve Firstup’s app in your Google Workspace organization using the client ID Firstup provides. | Enable the integration and provide the app details and administrator approval requirements for your environment. |
If you choose your own internal app, only accounts within your Google Workspace organization can use it.
Audience Targeting
You can ask Firstup to target the Google Search integration to a specific audience in your community. Users outside that audience do not see the integration’s search option.
If you want to limit visibility, provide your Firstup representative with the audience you want to use during setup.
Each user must connect their Google account before searching. Audience membership does not grant access to Google content. Search results depend on the connected account’s Google permissions and any source restrictions configured for your community.
Technical Details
Authorization and Permissions
You connect your Google account through OAuth. The integration requests access to your email address, basic profile information, and Google Drive content using the following scopes:
| Scope | Access |
|---|---|
https://www.googleapis.com/auth/userinfo.email |
Your Google account email address. |
https://www.googleapis.com/auth/userinfo.profile |
Your basic Google profile information. |
https://www.googleapis.com/auth/drive.readonly |
Read-only access to Google Drive files you can access. |
https://www.googleapis.com/auth/drive.metadata.readonly |
Read-only access to Google Drive file metadata. |
Configure Google Search Integration
Complete the instructions for your chosen app option.
Option 1: Use Your Own Google App
Step 1: Create a Google Cloud Project
- Sign in to Google Cloud Console.
- Select Create Project.
- Enter a project name, such as Firstup Search Integration, and select your organization.
- Select Create, then open your new project.
- Go to APIs & Services > Enabled APIs & services.
- Select Enable APIs and Services, find Google Drive API, and select Enable.
Step 2: Configure OAuth Consent
- Open the project’s OAuth consent configuration. In Google’s current console, you manage these settings under Google Auth platform.
- Set your audience to Internal.
- Enter an app name, user support email, and developer contact email. You can also add an app logo and your Firstup web experience URL as the application home page.
- Add these authorized domains:
socialchorus.com,onfirstup.eu, andonfirstup.com. - In Data Access, add the four scopes listed in Authorization and Permissions.
- Review and save your configuration.
Step 3: Create OAuth Credentials
- Open Google Auth platform > Clients and select Create Client.
- Select Web application and enter a name for your client.
- Add the authorized JavaScript origin and redirect URI for your community’s hosting region using the table below.
- Select Create, then copy your client ID and client secret or download the credentials JSON file.
| Region | Authorized JavaScript origin | Authorized redirect URI |
|---|---|---|
| US1 | https://eva.socialchorus.com |
https://eva.socialchorus.com/api/v1/integrations/google_drive/callback |
| US2 | https://eva.us2.onfirstup.com |
https://eva.us2.onfirstup.com/api/v1/integrations/google_drive/callback |
| EU | https://eva.onfirstup.eu |
https://eva.onfirstup.eu/api/v1/integrations/google_drive/callback |
Step 4: Provide Your Credentials to Firstup
Contact your Firstup representative and provide:
- Your Firstup community name or URL.
- Your OAuth client ID and client secret, or the downloaded credentials JSON file.
Ask your representative how to transfer the credentials securely.
Firstup uses your credentials to configure the integration and enable Google Drive search for your community. Wait for Firstup to confirm that setup is complete before you connect your account.
Option 2: Use Firstup’s Google App
Step 1: Request Setup from Firstup
Contact your Firstup representative with your community name or URL and confirm that you want to use Firstup’s Google app. Firstup enables the integration and provides the OAuth client ID and Google Workspace approval requirements for your environment.
Step 2: Approve the App in Google Workspace
- Sign in to your Google Admin console with an administrator account.
- Open Security > Access and data control > API controls, then open Manage Third-Party App Access.
- Add an app using the OAuth client ID Firstup provides.
- Review the requested scopes and configure access to allow the integration under your organization’s policies. Work with Firstup to confirm the appropriate access setting.
- Complete any additional administrator authorization that Firstup confirms your environment requires.
After you complete the Google Workspace configuration and Firstup confirms enablement, you can connect your account.
Limit Search to Specific Google Sources
You can ask Firstup to limit Google Search results to selected Google Sites, Shared Drives, and Google Drive folders. Firstup manages this configuration for your community.
Scoping limits which sources you can search. It does not grant access to content. You still need the appropriate Google permissions to find content within the selected sources.
Step 1: Collect Your Source URLs or IDs
Identify the sources you want to include and collect the following information:
| Source | What to provide |
|---|---|
| Google Site | The site’s editor URL, such as https://sites.google.com/d/{SITE_ID}/edit, or its resource ID. |
| Google Shared Drive | The Shared Drive URL or resource ID. |
| Google Drive folder | The folder URL or resource ID. |
You can include multiple sources. Individual file links, including Google Docs, Sheets, and Slides links, cannot serve as search sources.
Step 2: Send Your Source List to Firstup
- Contact your Firstup representative and provide your community name or URL.
- Provide the URLs or IDs for all Google Sites, Shared Drives, and folders you want to include.
- Firstup applies the source list to your community’s Google integration and confirms when you can test the configuration.
To change your search sources later, contact your Firstup representative with your updated list.
If you do not configure source restrictions, Google Search retains its default behavior and searches Google content available to your connected account.
Google Sites Requirements and Limitations
- To find a Google Site through this integration, you need Drive access to the underlying site, such as draft or editor access. Permission to view the published site alone is insufficient.
- Provide the site’s editor URL or resource ID. Published URLs, including
sites.google.com/view/...URLs, do not contain the resource ID required for configuration. - Search does not treat text inside an embedded document as part of the Google Site. To search the embedded file, include its containing folder or Shared Drive in your source list.
Connect Your Account
- Open your Firstup web experience and find the Google integration through Search or Assistant.
- Select Connect Account.
- Sign in to your Google account and follow the prompts to authorize the connection.
- Search for Google Drive content from Firstup.
Your search results reflect your connected Google account’s permissions and any source restrictions configured for your community. For more information about connecting and using integrations, see Integrated Search.
Comments
0 comments
Please sign in to leave a comment.