Index
-
GSuiteAddOns
(interface) -
AddOns
(message) -
Authorization
(message) -
CreateDeploymentRequest
(message) -
DeleteDeploymentRequest
(message) -
Deployment
(message) -
GetAuthorizationRequest
(message) -
GetDeploymentRequest
(message) -
GetInstallStatusRequest
(message) -
InstallDeploymentRequest
(message) -
InstallStatus
(message) -
ListDeploymentsRequest
(message) -
ListDeploymentsResponse
(message) -
ReplaceDeploymentRequest
(message) -
UninstallDeploymentRequest
(message)
GSuiteAddOns
A service for managing Google Workspace add-on deployments.
rpc CreateDeployment(
CreateDeploymentRequest
) returns ( Deployment
)
Creates a deployment with the specified name and configuration.
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authorization guide .
-
rpc DeleteDeployment(
DeleteDeploymentRequest
) returns ( Empty
)
Deletes the deployment with the given name.
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authorization guide .
-
rpc GetAuthorization(
GetAuthorizationRequest
) returns ( Authorization
)
Gets the authorization information for deployments in a given project.
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authorization guide .
-
rpc GetDeployment(
GetDeploymentRequest
) returns ( Deployment
)
Gets the deployment with the specified name.
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authorization guide .
-
rpc GetInstallStatus(
GetInstallStatusRequest
) returns ( InstallStatus
)
Gets the install status of a test deployment.
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authorization guide .
-
rpc InstallDeployment(
InstallDeploymentRequest
) returns ( Empty
)
Installs a deployment to your account for testing. For more information, see Test your add-on
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authorization guide .
-
rpc ListDeployments(
ListDeploymentsRequest
) returns ( ListDeploymentsResponse
)
Lists all deployments in a particular project.
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authorization guide .
-
rpc ReplaceDeployment(
ReplaceDeploymentRequest
) returns ( Deployment
)
Creates or replaces a deployment with the specified name.
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authorization guide .
-
rpc UninstallDeployment(
UninstallDeploymentRequest
) returns ( Empty
)
Uninstalls a test deployment from the user’s account. For more information, see Test your add-on .
- Authorization scopes
-
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authorization guide .
-
AddOns
A Google Workspace add-on configuration.
Fields | |
---|---|
common
|
Configuration that is common across all Google Workspace add-ons. |
gmail
|
Gmail add-on configuration. |
drive
|
Drive add-on configuration. |
calendar
|
Calendar add-on configuration. |
docs
|
Docs add-on configuration. |
meet
|
Meet add-on configuration. |
sheets
|
Sheets add-on configuration. |
slides
|
Slides add-on configuration. |
httpOptions
|
Options for sending requests to add-on HTTP endpoints |
Authorization
The authorization information used when invoking deployment endpoints.
Fields | |
---|---|
name
|
The canonical full name of this resource. Example: |
serviceAccountEmail
|
The email address of the service account used to authenticate requests to add-on callback endpoints. |
oauthClientId
|
The OAuth client ID used to obtain OAuth access tokens for a user on the add-on's behalf. |
CreateDeploymentRequest
Request message to create a deployment.
parent
string
Required. Name of the project in which to create the deployment.
Example: projects/my_project
.
Authorization requires the following IAM
permission on the specified resource parent
:
-
gsuiteaddons.deployments.create
deploymentId
string
Required. The ID to use for this deployment. The full name of the created resource will be projects/<project_number>/deployments/<deployment_id>
.
deployment
Required. The deployment to create (deployment.name cannot be set).
DeleteDeploymentRequest
Request message to delete a deployment.
name
string
Required. The full resource name of the deployment to delete.
Example: projects/my_project/deployments/my_deployment
.
Authorization requires the following IAM
permission on the specified resource name
:
-
gsuiteaddons.deployments.delete
etag
string
The etag of the deployment to delete. If this is provided, it must match the server's etag.
Deployment
A Google Workspace add-on deployment
Fields | |
---|---|
name
|
The deployment resource name. Example: |
oauthScopes[]
|
The list of Google OAuth scopes for which to request consent from the end user before executing an add-on endpoint. |
addOns
|
The Google Workspace add-on configuration. |
etag
|
This value is computed by the server based on the version of the deployment in storage, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. |
GetAuthorizationRequest
Request message to get the Google Workspace add-on authorization information.
name
string
Required. Name of the project for which to get the Google Workspace add-on authorization information.
Example: projects/my_project/authorization
.
Authorization requires the following IAM
permission on the specified resource name
:
-
gsuiteaddons.authorizations.get
GetDeploymentRequest
Request message to get a deployment.
name
string
Required. The full resource name of the deployment to get.
Example: projects/my_project/deployments/my_deployment
.
Authorization requires the following IAM
permission on the specified resource name
:
-
gsuiteaddons.deployments.get
GetInstallStatusRequest
Request message to get the install status of a test deployment.
name
string
Required. The full resource name of the deployment.
Example: projects/my_project/deployments/my_deployment/installStatus
.
Authorization requires the following IAM
permission on the specified resource name
:
-
gsuiteaddons.deployments.installStatus
InstallDeploymentRequest
Request message to install a deployment for testing.
name
string
Required. The full resource name of the deployment to install.
Example: projects/my_project/deployments/my_deployment
.
Authorization requires the following IAM
permission on the specified resource name
:
-
gsuiteaddons.deployments.install
InstallStatus
Install status of a test deployment.
Fields | |
---|---|
name
|
The canonical full resource name of the deployment install status. Example: |
installed
|
True if the deployment is installed for the user. |
ListDeploymentsRequest
Request message to list deployments for a project.
parent
string
Required. Name of the project in which to create the deployment.
Example: projects/my_project
.
Authorization requires the following IAM
permission on the specified resource parent
:
-
gsuiteaddons.deployments.list
pageSize
int32
The maximum number of deployments to return. The service might return fewer than this value. If unspecified, at most 1,000 deployments are returned. The maximum possible value is 1,000; values above 1,000 are changed to 1,000.
pageToken
string
A page token, received from a previous ListDeployments
call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to ListDeployments
must match the call that provided the page token.
ListDeploymentsResponse
Response message to list deployments.
Fields | |
---|---|
deployments[]
|
The list of deployments for the given project. |
nextPageToken
|
A token, which can be sent as |
ReplaceDeploymentRequest
Request message to create or replace a deployment.
deployment
Required. The deployment to create or replace.
Authorization requires the following IAM
permission on the specified resource deployment
:
-
gsuiteaddons.deployments.update
UninstallDeploymentRequest
Request message to uninstall a test deployment.
name
string
Required. The full resource name of the deployment to install.
Example: projects/my_project/deployments/my_deployment
.
Authorization requires the following IAM
permission on the specified resource name
:
-
gsuiteaddons.deployments.execute