# Google Workspace

Google Workspace (opens new window), formerly known as G Suite, is a collection of cloud computing, productivity, and collaboration tools, software, and products developed by Google.

Workato enables you to add, delete, update, fetch, or search for any objects, such as users, groups, or roles. For example, while on-boarding new employees, the employee details need to be added into the Google Workspace.

# API version

Workato's Google Workspace connector currently uses Google Admin SDK (opens new window) for connecting to the admin services.

# How to connect to Google Workspace on Workato

Connecting to Google Workspace connector is as simple as signing in to the Google account.

Select Connect: Setup step 1

Sign in with your Google account. Do note that your Google account should have Admin privileges to make such organisation wide changes in Google Workspace. Setup step 2

Workato provides the provision to setup the scope or the permission for the specific connection through "Advanced Settings". The following scopes are always provided by default - "View and manage the provisioning of users on your domain", "View and manage organization units on your domain", "View domains related to your customers", "View user schemas on your domain" "View and manage the provisioning of groups on your domain", "View and manage the provisioning of group members on your domain", "View and manage data transfers between users in your organization", "Manage your mobile devices by performing administrative tasks" "View audit reports for your G Suite domain", "View usage reports for your G Suite domain", "Manage delegated admin roles for your domain".

Setup step 3

Additionally, the below mentioned scopes can be included using the multi select option.

Setup step 4

For more detailed information about the scopes, please refer here (opens new window)

And you are good to go: Setup step 3

# Google Workspace - Action objects

Workato allows you to add, delete, update, fetch, or search for objects on Google Workspace. Here, we are classifying User, User alias, Groups, etc as objects. Note that the entries for input fields will change depending on the objects chosen. The list of objects used can be found below.

Objects Description
User Perform an action on a user
User alias Perform an action on the aliases associated with a user, which are alternate email addresses
Group Perform an action on a user group
Organizational unit Perform an action on an organizational unit
Member to group Perform an action on a user with relation to a group
Role assignment Perform an action relating to user role assignment. These are synonymous with Admin roles
Verification code Perform an action relating to verification codes. Verification codes allow users to recover their accounts when 2 step authentication is enabled
App specific password Perform an action relating to an app specific password. App specific passwords are used to access apps or devices which do not enforce 2-step verification. Users can generate these passwords and you can use Workato to revoke these passwords in the event of lost devices or re-provisioning of apps
Access token Perform an action relating to access token of an application under a user
Mobile Device Perform an action relating to mobile device associated with a user
License Perform an action relating to license of various Google products

When using Google Workspace actions in Workato, you'll be able to specify which object you want to use.