This page lists the IAM roles and permissions for Google Workspace add-ons. To
search through all roles and permissions, see the [role and
permission index](https://docs.cloud.google.com/iam/docs/roles-permissions).

## Google Workspace add-ons roles

| Role | Permissions |
|---|---|
| #### Google Workspace Add-ons Admin (`roles/gsuiteaddons.admin`) Admin role for Google Workspace Add-ons | `chat.*` - `chat.bots.get` - `chat.bots.update` `gsuiteaddons.*` - `gsuiteaddons.authorizations.get` - `gsuiteaddons.chatAppConfigs.get` - `gsuiteaddons.chatAppConfigs.update` - `gsuiteaddons.deployments.create` - `gsuiteaddons.deployments.delete` - `gsuiteaddons.deployments.execute` - `gsuiteaddons.deployments.get` - `gsuiteaddons.deployments.install` - `gsuiteaddons.deployments.installStatus` - `gsuiteaddons.deployments.list` - `gsuiteaddons.deployments.uninstall` - `gsuiteaddons.deployments.update` `resourcemanager.projects.get` `resourcemanager.projects.list` |
| #### Google Workspace Add-ons Viewer (`roles/gsuiteaddons.viewer`) Viewer role for Google Workspace Add-ons | `chat.bots.get` `gsuiteaddons.authorizations.get` `gsuiteaddons.chatAppConfigs.get` `gsuiteaddons.deployments.get` `gsuiteaddons.deployments.list` `resourcemanager.projects.get` `resourcemanager.projects.list` |
| #### Google Workspace Add-ons Developer (`roles/gsuiteaddons.developer`) Full access to Google Workspace Add-ons resources | `chat.*` - `chat.bots.get` - `chat.bots.update` `gsuiteaddons.*` - `gsuiteaddons.authorizations.get` - `gsuiteaddons.chatAppConfigs.get` - `gsuiteaddons.chatAppConfigs.update` - `gsuiteaddons.deployments.create` - `gsuiteaddons.deployments.delete` - `gsuiteaddons.deployments.execute` - `gsuiteaddons.deployments.get` - `gsuiteaddons.deployments.install` - `gsuiteaddons.deployments.installStatus` - `gsuiteaddons.deployments.list` - `gsuiteaddons.deployments.uninstall` - `gsuiteaddons.deployments.update` `resourcemanager.projects.get` `resourcemanager.projects.list` |
| #### Google Workspace Add-ons Reader (`roles/gsuiteaddons.reader`) Read-only access to Google Workspace Add-ons resources | `chat.bots.get` `gsuiteaddons.authorizations.get` `gsuiteaddons.chatAppConfigs.get` `gsuiteaddons.deployments.get` `gsuiteaddons.deployments.list` `resourcemanager.projects.get` `resourcemanager.projects.list` |
| #### Google Workspace Add-ons Tester (`roles/gsuiteaddons.tester`) Testing execution access to Google Workspace Add-ons resources | `gsuiteaddons.deployments.execute` `gsuiteaddons.deployments.install` `gsuiteaddons.deployments.installStatus` `gsuiteaddons.deployments.uninstall` `resourcemanager.projects.get` `resourcemanager.projects.list` |

## Google Workspace add-ons permissions

| Permission | Included in roles |
|---|---|
| #### `gsuiteaddons.authorizations.get` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Google Workspace Add-ons Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.viewer) (`roles/gsuiteaddons.viewer`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) [Google Workspace Add-ons Reader](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.reader) (`roles/gsuiteaddons.reader`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `gsuiteaddons.chatAppConfigs.get` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Google Workspace Add-ons Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.viewer) (`roles/gsuiteaddons.viewer`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) [Google Workspace Add-ons Reader](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.reader) (`roles/gsuiteaddons.reader`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `gsuiteaddons.chatAppConfigs.update` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) |
| #### `gsuiteaddons.deployments.create` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Workspace Marketplace App Configuration Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/workspacemarketplace.md.txt#appmetadata.workspaceMarketplaceAppConfigurationAdmin) (`roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) |
| #### `gsuiteaddons.deployments.delete` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Workspace Marketplace App Configuration Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/workspacemarketplace.md.txt#appmetadata.workspaceMarketplaceAppConfigurationAdmin) (`roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) |
| #### `gsuiteaddons.deployments.execute` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) [Google Workspace Add-ons Tester](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.tester) (`roles/gsuiteaddons.tester`) |
| #### `gsuiteaddons.deployments.get` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Google Workspace Add-ons Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.viewer) (`roles/gsuiteaddons.viewer`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) [Google Workspace Add-ons Reader](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.reader) (`roles/gsuiteaddons.reader`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `gsuiteaddons.deployments.install` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) [Google Workspace Add-ons Tester](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.tester) (`roles/gsuiteaddons.tester`) |
| #### `gsuiteaddons.deployments.installStatus` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) [Google Workspace Add-ons Tester](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.tester) (`roles/gsuiteaddons.tester`) |
| #### `gsuiteaddons.deployments.list` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Reader](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/reader`) [Viewer (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/viewer`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Google Workspace Add-ons Viewer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.viewer) (`roles/gsuiteaddons.viewer`) [Security Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityAdmin) (`roles/iam.securityAdmin`) [Security Reviewer](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityReviewer) (`roles/iam.securityReviewer`) [Workspace Marketplace App Configuration Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/workspacemarketplace.md.txt#appmetadata.workspaceMarketplaceAppConfigurationAdmin) (`roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) [Google Workspace Add-ons Reader](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.reader) (`roles/gsuiteaddons.reader`) [Security Auditor](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.securityAuditor) (`roles/iam.securityAuditor`) [Support User](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.supportUser) (`roles/iam.supportUser`) |
| #### `gsuiteaddons.deployments.uninstall` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) [Google Workspace Add-ons Tester](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.tester) (`roles/gsuiteaddons.tester`) |
| #### `gsuiteaddons.deployments.update` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Google Workspace Add-ons Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.admin) (`roles/gsuiteaddons.admin`) [Workspace Marketplace App Configuration Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/workspacemarketplace.md.txt#appmetadata.workspaceMarketplaceAppConfigurationAdmin) (`roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin`) [Google Workspace Add-ons Developer](https://docs.cloud.google.com/iam/docs/roles-permissions/gsuiteaddons.md.txt#gsuiteaddons.developer) (`roles/gsuiteaddons.developer`) |