Prerequisites
- A Google Workspace domain.
- Administrative privileges to install Marketplace apps.
OAuth Scopes
OAuth Scopes ExplanationThe following OAuth scopes are used by the Orbb app:
userinfo.email/userinfo.profile: Basic user identity information for authentication.admin.directory.user.readonly: Read-only access to user directory information in Google Workspace.calendar.readonly: Read-only access to calendar events.gmail.metadata: Access to email metadata (subject, sender, recipients, date) without reading message content.appsmarketplace.license: Required for Marketplace license validation.
Installation Guide
1. Navigate to the Marketplace App
- Open the Orbb Relationship AI Platform in the Google Workspace Marketplace.
2. Install for Your Organization
- Click Admin Install to begin the installation process.
- Sign in with your Google Workspace administrator account if prompted.
3. Select Users
Choose which users will have access to the app:- Everyone at your organization: Install the app for all users in your domain.
- Certain groups or organizational units: Select specific organizational units (OUs) or groups to limit which users’ data the app can access.
4. Review and Authorize
- Review the requested permissions (OAuth scopes listed above).
- Click Authorize to grant the app access to the selected users’ data.
- Click Finish to complete the installation.
Limiting Access to Specific Users
The Marketplace app installation allows granular control over which users’ data can be accessed:-
Using Organizational Units (OUs)
- Navigate to Google Admin Console > Directory > Organizational units.
- Create or select an OU containing the users whose data should be accessible.
- When installing or managing the app, select this OU instead of the entire organization.
-
Using Access Groups
- Create a group in Directory > Groups containing the target users.
- Select this group during app installation to limit data access to group members only.
-
Managing Access After Installation
- Go to Apps > Google Workspace Marketplace apps > Apps list.
- Click on the Orbb app to modify which OUs or groups have access.
For more details on managing app access, see Install Marketplace apps for your organization.
App vs Service Account
For the service account approach, see the Google Workspace documentation.