# 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:
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.
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".
Additionally, the below mentioned scopes can be included using the multi select option.
For more detailed information about the scopes, please refer here (opens new window)
And you are good to go:
# 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.