本頁面由 Cloud Translation API 翻譯而成。

Package google.cloud.gsuiteaddons.v1

索引

GSuiteAddOns (介面)
AddOns (訊息)
Authorization (訊息)
CreateDeploymentRequest (訊息)
DeleteDeploymentRequest (訊息)
Deployment (訊息)
GetAuthorizationRequest (訊息)
GetDeploymentRequest (訊息)
GetInstallStatusRequest (訊息)
InstallDeploymentRequest (訊息)
InstallStatus (訊息)
ListDeploymentsRequest (訊息)
ListDeploymentsResponse (訊息)
ReplaceDeploymentRequest (訊息)
UninstallDeploymentRequest (訊息)

GSuiteAddOns

用於管理 Google Workspace 外掛程式部署作業的服務。

CreateDeployment

CreateDeployment
`rpc CreateDeployment(CreateDeploymentRequest) returns (Deployment)` 建立具有指定名稱和設定的部署。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/cloud-platform` 詳情請參閱 OAuth 2.0 Overview。

rpc CreateDeployment(CreateDeploymentRequest) returns (Deployment)

建立具有指定名稱和設定的部署。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

DeleteDeployment

DeleteDeployment
`rpc DeleteDeployment(DeleteDeploymentRequest) returns (Empty)` 刪除指定名稱的部署作業。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/cloud-platform` 詳情請參閱 OAuth 2.0 Overview。

rpc DeleteDeployment(DeleteDeploymentRequest) returns (Empty)

刪除指定名稱的部署作業。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

GetAuthorization

GetAuthorization
`rpc GetAuthorization(GetAuthorizationRequest) returns (Authorization)` 取得指定專案中部署作業的授權資訊。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/cloud-platform` 詳情請參閱 OAuth 2.0 Overview。

rpc GetAuthorization(GetAuthorizationRequest) returns (Authorization)

取得指定專案中部署作業的授權資訊。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

GetDeployment

GetDeployment
`rpc GetDeployment(GetDeploymentRequest) returns (Deployment)` 取得指定名稱的部署作業。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/cloud-platform` 詳情請參閱 OAuth 2.0 Overview。

rpc GetDeployment(GetDeploymentRequest) returns (Deployment)

取得指定名稱的部署作業。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

GetInstallStatus

GetInstallStatus
`rpc GetInstallStatus(GetInstallStatusRequest) returns (InstallStatus)` 取得測試部署作業的安裝狀態。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/cloud-platform` 詳情請參閱 OAuth 2.0 Overview。

rpc GetInstallStatus(GetInstallStatusRequest) returns (InstallStatus)

取得測試部署作業的安裝狀態。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

InstallDeployment

InstallDeployment
`rpc InstallDeployment(InstallDeploymentRequest) returns (Empty)` 在帳戶中安裝部署項目以進行測試。詳情請參閱「測試外掛程式」授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/cloud-platform` 詳情請參閱 OAuth 2.0 Overview。

rpc InstallDeployment(InstallDeploymentRequest) returns (Empty)

在帳戶中安裝部署項目以進行測試。詳情請參閱「測試外掛程式」

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

ListDeployments

ListDeployments
`rpc ListDeployments(ListDeploymentsRequest) returns (ListDeploymentsResponse)` 列出特定專案中的所有部署項目。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/cloud-platform` 詳情請參閱 OAuth 2.0 Overview。

rpc ListDeployments(ListDeploymentsRequest) returns (ListDeploymentsResponse)

列出特定專案中的所有部署項目。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

ReplaceDeployment

ReplaceDeployment
`rpc ReplaceDeployment(ReplaceDeploymentRequest) returns (Deployment)` 建立或取代指定名稱的部署。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/cloud-platform` 詳情請參閱 OAuth 2.0 Overview。

rpc ReplaceDeployment(ReplaceDeploymentRequest) returns (Deployment)

建立或取代指定名稱的部署。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

UninstallDeployment

UninstallDeployment
`rpc UninstallDeployment(UninstallDeploymentRequest) returns (Empty)` 從使用者帳戶中解除安裝測試部署。詳情請參閱「測試外掛程式」。授權範圍需要下列 OAuth 範圍： `https://www.googleapis.com/auth/cloud-platform` 詳情請參閱 OAuth 2.0 Overview。

rpc UninstallDeployment(UninstallDeploymentRequest) returns (Empty)

從使用者帳戶中解除安裝測試部署。詳情請參閱「測試外掛程式」。

授權範圍

需要下列 OAuth 範圍：

https://www.googleapis.com/auth/cloud-platform

詳情請參閱 OAuth 2.0 Overview。

AddOns

Google Workspace 外掛程式設定。

欄位
`common`	`CommonAddOnManifest` 所有 Google Workspace 外掛程式都適用的設定。
`gmail`	`GmailAddOnManifest` Gmail 外掛程式設定。
`drive`	`DriveAddOnManifest` 雲端硬碟外掛程式設定。
`calendar`	`CalendarAddOnManifest` 日曆外掛程式設定。
`docs`	`DocsAddOnManifest` Google 文件外掛程式設定。
`sheets`	`SheetsAddOnManifest` 試算表外掛程式設定。
`slides`	`SlidesAddOnManifest` 簡報外掛程式設定。
`httpOptions`	`HttpOptions` 將要求傳送至外掛 HTTP 端點的選項

授權

叫用部署端點時使用的授權資訊。

欄位

欄位
`name`	`string` 此資源的標準完整名稱。範例：`projects/123/authorization`
`serviceAccountEmail`	`string` 用於驗證外掛程式回呼端點要求的服務帳戶電子郵件地址。
`oauthClientId`	`string` 用於代表外掛程式為使用者取得 OAuth 存取權權杖的 OAuth 用戶端 ID。

name

string

此資源的標準完整名稱。範例：projects/123/authorization

serviceAccountEmail

string

用於驗證外掛程式回呼端點要求的服務帳戶電子郵件地址。

oauthClientId

string

用於代表外掛程式為使用者取得 OAuth 存取權權杖的 OAuth 用戶端 ID。

CreateDeploymentRequest

建立部署作業的要求訊息。

欄位

欄位
`parent`	`string` 必要欄位。要建立部署作業的專案名稱。範例：`projects/my_project`。授權需要指定資源 `parent` 的下列 IAM 權限： `gsuiteaddons.deployments.create`
`deploymentId`	`string` 必要欄位。要用於這項部署作業的 ID。建立的資源完整名稱會是 `projects/<project_number>/deployments/<deployment_id>`。
`deployment`	`Deployment` 必要欄位。要建立的部署作業 (無法設定 deployment.name)。

parent

string

必要欄位。要建立部署作業的專案名稱。

範例：projects/my_project。

授權需要指定資源 parent 的下列 IAM 權限：

gsuiteaddons.deployments.create

deploymentId

string

必要欄位。要用於這項部署作業的 ID。建立的資源完整名稱會是 projects/<project_number>/deployments/<deployment_id>。

deployment

Deployment

必要欄位。要建立的部署作業 (無法設定 deployment.name)。

DeleteDeploymentRequest

要求訊息，用於刪除部署作業。

欄位

欄位
`name`	`string` 必要欄位。要刪除的部署作業的完整資源名稱。範例：`projects/my_project/deployments/my_deployment`。授權需要指定資源 `name` 的下列 IAM 權限： `gsuiteaddons.deployments.delete`
`etag`	`string` 要刪除的部署作業 etag。如果提供這項資訊，則必須與伺服器的 etag 相符。

name

string

必要欄位。要刪除的部署作業的完整資源名稱。

範例：projects/my_project/deployments/my_deployment。

授權需要指定資源 name 的下列 IAM 權限：

gsuiteaddons.deployments.delete

etag

string

要刪除的部署作業 etag。如果提供這項資訊，則必須與伺服器的 etag 相符。

部署作業

Google Workspace 外掛程式部署

欄位
`name`	`string` 部署資源名稱。範例：`projects/123/deployments/my_deployment`。
`oauthScopes[]`	`string` 執行外掛程式端點前，需要向使用者索取同意聲明的 Google OAuth 範圍清單。
`addOns`	`AddOns` Google Workspace 外掛程式設定。
`etag`	`string` 這個值是由伺服器根據儲存空間中部署版本計算得出，可能會在更新和刪除要求時傳送，以確保用戶端在繼續操作前擁有最新的值。

GetAuthorizationRequest

要求訊息，用於取得 Google Workspace 外掛程式授權資訊。

欄位

欄位
`name`	`string` 必要欄位。取得 Google Workspace 外掛程式授權資訊的專案名稱。範例：`projects/my_project/authorization`。授權需要指定資源 `name` 的下列 IAM 權限： `gsuiteaddons.authorizations.get`

name

string

必要欄位。取得 Google Workspace 外掛程式授權資訊的專案名稱。

範例：projects/my_project/authorization。

授權需要指定資源 name 的下列 IAM 權限：

gsuiteaddons.authorizations.get

GetDeploymentRequest

取得部署作業的請求訊息。

欄位

欄位
`name`	`string` 必要欄位。要取得的部署作業的完整資源名稱。範例：`projects/my_project/deployments/my_deployment`。授權需要指定資源 `name` 的下列 IAM 權限： `gsuiteaddons.deployments.get`

name

string

必要欄位。要取得的部署作業的完整資源名稱。

範例：projects/my_project/deployments/my_deployment。

授權需要指定資源 name 的下列 IAM 權限：

gsuiteaddons.deployments.get

GetInstallStatusRequest

要求訊息，用於取得測試部署的安裝狀態。

欄位

欄位
`name`	`string` 必要欄位。部署作業的完整資源名稱。範例：`projects/my_project/deployments/my_deployment/installStatus`。授權需要指定資源 `name` 的下列 IAM 權限： `gsuiteaddons.deployments.installStatus`

name

string

必要欄位。部署作業的完整資源名稱。

範例：projects/my_project/deployments/my_deployment/installStatus。

授權需要指定資源 name 的下列 IAM 權限：

gsuiteaddons.deployments.installStatus

InstallDeploymentRequest

要求訊息，用於安裝測試用的部署。

欄位

欄位
`name`	`string` 必要欄位。要安裝的部署作業的完整資源名稱。範例：`projects/my_project/deployments/my_deployment`。授權需要指定資源 `name` 的下列 IAM 權限： `gsuiteaddons.deployments.install`

name

string

必要欄位。要安裝的部署作業的完整資源名稱。

範例：projects/my_project/deployments/my_deployment。

授權需要指定資源 name 的下列 IAM 權限：

gsuiteaddons.deployments.install

InstallStatus

測試部署的安裝狀態。

欄位

欄位
`name`	`string` 部署安裝狀態的標準完整資源名稱。範例：`projects/123/deployments/my_deployment/installStatus`。
`installed`	`BoolValue` 如果已為使用者安裝部署作業，則為 true。

name

string

部署安裝狀態的標準完整資源名稱。

範例：projects/123/deployments/my_deployment/installStatus。

installed

BoolValue

如果已為使用者安裝部署作業，則為 true。

ListDeploymentsRequest

列出專案部署項目的要求訊息。

欄位

欄位
`parent`	`string` 必要欄位。要建立部署作業的專案名稱。範例：`projects/my_project`。授權需要指定資源 `parent` 的下列 IAM 權限： `gsuiteaddons.deployments.list`
`pageSize`	`int32` 要傳回的部署作業數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多會傳回 1,000 個部署。許可的最大值為 1,000；超出的數值將一律指定為 1,000。
`pageToken`	`string` 屬於接收自前一個 `ListDeployments` 呼叫的網頁權杖。提供此項目即可擷取後續網頁。進行分頁時，提供至 `ListDeployments` 的所有其他參數須與提供網頁權杖的呼叫相符。

parent

string

必要欄位。要建立部署作業的專案名稱。

範例：projects/my_project。

授權需要指定資源 parent 的下列 IAM 權限：

gsuiteaddons.deployments.list

pageSize

int32

要傳回的部署作業數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多會傳回 1,000 個部署。許可的最大值為 1,000；超出的數值將一律指定為 1,000。

pageToken

string

屬於接收自前一個 ListDeployments 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 ListDeployments 的所有其他參數須與提供網頁權杖的呼叫相符。

ListDeploymentsResponse

回應訊息，用於列出部署作業。

欄位

欄位
`deployments[]`	`Deployment` 指定專案的部署清單。
`nextPageToken`	`string` 可做為 `page_token` 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

deployments[]

Deployment

指定專案的部署清單。

nextPageToken

string

可做為 page_token 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

ReplaceDeploymentRequest

建立或取代部署作業的要求訊息。

欄位

欄位
`deployment`	`Deployment` 必要欄位。要建立或取代的部署。授權需要指定資源 `deployment` 的下列 IAM 權限： `gsuiteaddons.deployments.update`

deployment

Deployment

必要欄位。要建立或取代的部署。

授權需要指定資源 deployment 的下列 IAM 權限：

gsuiteaddons.deployments.update

UninstallDeploymentRequest

要求訊息，用於解除安裝測試部署。

欄位

欄位
`name`	`string` 必要欄位。要安裝的部署作業的完整資源名稱。範例：`projects/my_project/deployments/my_deployment`。授權需要指定資源 `name` 的下列 IAM 權限： `gsuiteaddons.deployments.execute`

name

string

必要欄位。要安裝的部署作業的完整資源名稱。

範例：projects/my_project/deployments/my_deployment。

授權需要指定資源 name 的下列 IAM 權限：

gsuiteaddons.deployments.execute