REST Resource: projects.deployments

資源:Deployment

Google Workspace 外掛程式部署作業

JSON 表示法
{
  "name": string,
  "oauthScopes": [
    string
  ],
  "addOns": {
    object (AddOns)
  },
  "etag": string
}
欄位
name

string

部署項目資源名稱。範例:projects/123/deployments/my_deployment

oauthScopes[]

string

在執行外掛程式端點之前,向使用者要求同意聲明的 Google OAuth 範圍清單。

addOns

object (AddOns)

Google Workspace 外掛程式設定。

etag

string

伺服器會根據儲存空間中的部署版本計算這個值,並可能會在更新與刪除要求時傳送,確保用戶端有最新的值再繼續。

AddOns

Google Workspace 外掛程式設定。

JSON 表示法
{
  "common": {
    object (CommonAddOnManifest)
  },
  "gmail": {
    object (GmailAddOnManifest)
  },
  "drive": {
    object (DriveAddOnManifest)
  },
  "calendar": {
    object (CalendarAddOnManifest)
  },
  "docs": {
    object (DocsAddOnManifest)
  },
  "sheets": {
    object (SheetsAddOnManifest)
  },
  "slides": {
    object (SlidesAddOnManifest)
  },
  "httpOptions": {
    object (HttpOptions)
  }
}
欄位
common

object (CommonAddOnManifest)

所有 Google Workspace 外掛程式通用的設定。

gmail

object (GmailAddOnManifest)

設定 Gmail 外掛程式。

drive

object (DriveAddOnManifest)

雲端硬碟外掛程式設定。

calendar

object (CalendarAddOnManifest)

日曆外掛程式設定。

docs

object (DocsAddOnManifest)

文件外掛程式設定。

sheets

object (SheetsAddOnManifest)

試算表外掛程式設定。

slides

object (SlidesAddOnManifest)

簡報外掛程式設定。

httpOptions

object (HttpOptions)

將要求傳送至外掛程式 HTTP 端點的選項

CommonAddOnManifest

所有外掛程式主機應用程式共用的外掛程式設定。

JSON 表示法
{
  "name": string,
  "logoUrl": string,
  "layoutProperties": {
    object (LayoutProperties)
  },
  "addOnWidgetSet": {
    object (AddOnWidgetSet)
  },
  "useLocaleFromApp": boolean,
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "universalActions": [
    {
      object (UniversalActionExtensionPoint)
    }
  ],
  "openLinkUrlPrefixes": array
}
欄位
name

string

必要欄位。外掛程式的顯示名稱。

logoUrl

string

必要欄位。外掛程式工具列中顯示的標誌圖片網址。

layoutProperties

object (LayoutProperties)

外掛程式資訊卡的常見版面配置屬性。

addOnWidgetSet

object (AddOnWidgetSet)

外掛程式中使用的小工具。如果未指定這個欄位,系統會使用預設的設定。

useLocaleFromApp

boolean

是否從主機應用程式傳遞語言代碼資訊。

homepageTrigger

object (HomepageExtensionPoint)

定義在任何結構定義中都會執行的端點。這個外掛程式產生的任何資訊卡一律會對使用者使用,但如果這個外掛程式宣告更針對性觸發條件,但情境內容可能就會出現這類資訊卡。

universalActions[]

object (UniversalActionExtensionPoint)

定義通用動作選單中的擴充功能點清單,做為外掛程式的設定選單。擴充功能點可以是要開啟的連結網址,也可以是做為表單提交執行的端點。

openLinkUrlPrefixes

array (ListValue format)

OpenLink 動作只能使用採用 HTTPSMAILTOTEL 配置的網址。如果是 HTTPS 連結,網址也必須符合許可清單中指定的其中一個前置字元。如果前置字串省略配置,系統會假設使用 HTTPS。系統會自動將 HTTP 個連結重新寫入 HTTPS 個連結。

LayoutProperties

所有外掛程式主機應用程式共用的資訊卡版面配置屬性。

JSON 表示法
{
  "primaryColor": string,
  "secondaryColor": string,
  "useNewMaterialDesign": boolean
}
欄位
primaryColor

string

外掛程式的主要顏色。即可設定工具列的顏色。如未設定主要顏色,系統會使用架構提供的預設值。

secondaryColor

string

外掛程式的次要顏色。可設定按鈕的顏色。如果已設定主要顏色,但未設定次要顏色,則次要顏色會與主要顏色相同。如果未設定主要顏色和次要顏色,則會使用架構提供的預設值。

useNewMaterialDesign

boolean

啟用資訊卡的質感設計。

AddOnWidgetSet

外掛程式使用的小工具子集。

JSON 表示法
{
  "usedWidgets": [
    enum (WidgetType)
  ]
}
欄位
usedWidgets[]

enum (WidgetType)

外掛程式中使用的小工具清單。

WidgetType

小工具類型。WIDGET_TYPE_UNSPECIFIED 是基本小工具組合。

列舉
WIDGET_TYPE_UNSPECIFIED 已設定的預設小工具。
DATE_PICKER 日期挑選器。
STYLED_BUTTONS 樣式按鈕包含填滿按鈕和已停用的按鈕。
PERSISTENT_FORMS 永久表單可讓您在動作期間保留表單值。
UPDATE_SUBJECT_AND_RECIPIENTS 更新草稿的主旨和收件者。
GRID_WIDGET 格線小工具。
ADDON_COMPOSE_UI_ACTION 套用至外掛程式撰寫 UI 的 Gmail 外掛程式動作。

HomepageExtensionPoint

宣告外掛程式首頁檢視畫面的常見格式。

JSON 表示法
{
  "runFunction": string,
  "enabled": boolean
}
欄位
runFunction

string

必要欄位。啟用這個擴充點時要執行的端點。

enabled

boolean

選用設定。如果設為 false,在這種情況下,系統會停用首頁檢視畫面。

如未設定,預設為 true

如果停用外掛程式的自訂首頁檢視畫面,系統會改為向使用者顯示一般總覽資訊卡。

UniversalActionExtensionPoint

宣告通用動作選單項目額外資訊點的格式。

JSON 表示法
{
  "label": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
欄位
label

string

必要欄位。向使用者顯示的文字,說明啟用這個擴充點所執行的動作,例如「新增聯絡人」。

聯集欄位 action_type。必要欄位。通用動作選單項目支援的動作類型。可以是開啟連結或執行的端點。action_type 只能是下列其中一項:
runFunction

string

UniversalAction 要執行的端點。

GmailAddOnManifest

屬性可自訂 Gmail 外掛程式的外觀和執行方式。

JSON 表示法
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "authorizationCheckFunction": string
}
欄位
homepageTrigger

object (HomepageExtensionPoint)

定義會在不符合宣告內容相關觸發條件的結構定義中執行的端點。這個外掛程式產生的任何資訊卡一律會對使用者使用,但如果這個外掛程式宣告更具目標性觸發條件,則含有情境內容可能就會出現這類資訊卡。

如有的話,這會覆寫 addons.common.homepageTrigger 的設定。

contextualTriggers[]

object (ContextualTrigger)

定義一組會觸發外掛程式的條件。

universalActions[]

object (UniversalAction)

定義一組外掛程式的通用動作。使用者透過外掛程式工具列選單觸發通用動作。

composeTrigger

object (ComposeTrigger)

定義撰寫時間外掛程式的撰寫時間觸發條件。這個觸發條件會在使用者撰寫電子郵件時,讓外掛程式採取行動。所有撰寫時間外掛程式都必須具備 gmail.addons.current.action.compose 範圍,即使不能編輯草稿也一樣。

authorizationCheckFunction

string

端點的名稱,用來解析第三方 API,確認外掛程式具備所有必要的第三方授權。如果探測失敗,函式應擲回例外狀況,以啟動授權流程。此函式會在每次叫用外掛程式之前呼叫,以確保流暢的使用者體驗。

ContextualTrigger

定義在開啟的電子郵件符合特定條件時觸發的觸發條件。觸發條件啟動時,會執行特定端點,以建立新資訊卡及更新 UI。

JSON 表示法
{
  "onTriggerFunction": string,

  // Union field trigger can be only one of the following:
  "unconditional": {
    object (UnconditionalTrigger)
  }
  // End of list of possible types for union field trigger.
}
欄位
onTriggerFunction

string

必要欄位。當訊息與觸發條件相符時,要呼叫的端點名稱。

聯集欄位 trigger。觸發條件類型會決定 Gmail 用來顯示外掛程式的條件。trigger 只能是下列其中一項:
unconditional

object (UnconditionalTrigger)

只要開啟任何郵件,系統就會執行無條件觸發程序。

UnconditionalTrigger

這個類型沒有任何欄位。

開啟任何電子郵件訊息時觸發的觸發條件。

UniversalAction

無論訊息內容為何,一律可以在外掛程式工具列選單中顯示的動作。

JSON 表示法
{
  "text": string,

  // Union field action_type can be only one of the following:
  "openLink": string,
  "runFunction": string
  // End of list of possible types for union field action_type.
}
欄位
text

string

必要欄位。使用者看到的動作說明文字,例如「新增聯絡人」。

聯集欄位 action_type。動作類型會決定使用者叫用動作時的 Gmail 行為。action_type 只能是下列其中一項:
runFunction

string

使用者觸發動作時呼叫的端點。詳情請參閱通用動作指南

ComposeTrigger

觸發條件會在使用者撰寫電子郵件時啟動。

JSON 表示法
{
  "actions": [
    {
      object (MenuItemExtensionPoint)
    }
  ],
  "draftAccess": enum (DraftAccess)
}
欄位
actions[]

object (MenuItemExtensionPoint)

定義撰寫時間外掛程式的動作組合。這些是使用者在撰寫時間外掛程式時可觸發的動作。

draftAccess

enum (DraftAccess)

定義觸發撰寫時間外掛程式時的資料存取權層級。

DraftAccess

列舉用於定義 Compose 觸發條件所需的資料存取權級別。

列舉
UNSPECIFIED 沒有為草稿存取權設定的預設值。
NONE 觸發 Compose 外掛程式時,撰寫觸發條件無法存取任何草稿資料。
METADATA 允許 Compose 觸發條件在觸發 Compose 外掛程式時存取草稿中繼資料。包括目標對象名單,例如郵件草稿的收件者和副本清單。

DriveAddOnManifest

用於自訂雲端硬碟外掛程式外觀和執行方式的屬性。

JSON 表示法
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onItemsSelectedTrigger": {
    object (DriveExtensionPoint)
  }
}
欄位
homepageTrigger

object (HomepageExtensionPoint)

如有的話,這會覆寫 addons.common.homepageTrigger 的設定。

onItemsSelectedTrigger

object (DriveExtensionPoint)

對應至使用者在相關雲端硬碟檢視畫面中選取項目時的行為,例如「我的雲端硬碟」文件清單。

DriveExtensionPoint

用於宣告雲端硬碟外掛程式觸發條件的常見格式。

JSON 表示法
{
  "runFunction": string
}
欄位
runFunction

string

必要欄位。啟用擴充點時要執行的端點。

CalendarAddOnManifest

屬性可自訂日曆外掛程式的外觀和執行方式。

JSON 表示法
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "createSettingsUrlFunction": string,
  "eventOpenTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventUpdateTrigger": {
    object (CalendarExtensionPoint)
  },
  "eventAttachmentTrigger": {
    object (MenuItemExtensionPoint)
  },
  "currentEventAccess": enum (EventAccess)
}
欄位
homepageTrigger

object (HomepageExtensionPoint)

定義在與宣告的內容相關觸發條件不符的結構定義中執行的端點。這個外掛程式產生的任何資訊卡一律會對使用者使用,但如果這個外掛程式宣告更針對性觸發條件,但情境內容可能就會出現這類資訊卡。

如有的話,這會覆寫 addons.common.homepageTrigger 的設定。

conferenceSolution[]

object (ConferenceSolution)

定義這項外掛程式提供的會議解決方案。

createSettingsUrlFunction

string

要執行的端點,會建立外掛程式設定頁面的網址。

eventOpenTrigger

object (CalendarExtensionPoint)

開放檢視或編輯事件時觸發的端點。

eventUpdateTrigger

object (CalendarExtensionPoint)

公開事件更新時觸發的端點。

eventAttachmentTrigger

object (MenuItemExtensionPoint)

情境觸發條件的設定,會在使用者點擊日曆下拉式選單中的外掛程式附件提供者時觸發。

currentEventAccess

enum (EventAccess)

定義觸發事件外掛程式時的資料存取權層級。

ConferenceSolution

定義會議相關價值。

JSON 表示法
{
  "onCreateFunction": string,
  "id": string,
  "name": string,
  "logoUrl": string
}
欄位
onCreateFunction

string

必要欄位。建立會議資料時要呼叫的端點。

id

string

必要欄位。只能在一項外掛程式中為會議解決方案指派專屬 ID,否則外掛程式觸發時,可能會使用錯誤的會議解決方案。雖然你可以變更外掛程式的顯示名稱,但請勿更改。

name

string

必要欄位。會議解決方案的顯示名稱。

logoUrl

string

必要欄位。會議解決方案的標誌圖片網址。

CalendarExtensionPoint

用於宣告日曆外掛程式觸發條件的常見格式。

JSON 表示法
{
  "runFunction": string
}
欄位
runFunction

string

必要欄位。啟用這個擴充點時要執行的端點。

EventAccess

列舉用來定義資料存取事件觸發條件所需的層級。

列舉
UNSPECIFIED 未設定 eventAccess 時的預設值。
METADATA 授予事件權限,讓觸發條件存取事件中繼資料 (例如活動 ID 和日曆 ID)。
READ 授予事件觸發條件對所有所提供活動欄位的存取權,包括中繼資料、參與者和會議資料。
WRITE 允許事件觸發條件存取活動中繼資料及執行所有操作,包括新增與會者及設定會議資料。
READ_WRITE 授予事件觸發條件對所有所提供活動欄位的存取權,包括中繼資料、參與者和會議資料,以及執行所有動作。

DocsAddOnManifest

屬性可自訂 Google 文件外掛程式的外觀與執行方式。

JSON 表示法
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (DocsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ],
  "createActionTriggers": [
    {
      object (CreateActionExtensionPoint)
    }
  ]
}
欄位
homepageTrigger

object (HomepageExtensionPoint)

如有的話,這會覆寫 addons.common.homepageTrigger 的設定。

onFileScopeGrantedTrigger

object (DocsExtensionPoint)

授予此文件/使用者組合的檔案範圍授權時,要執行的端點。

linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

在 Google 文件中預覽連結的擴充點清單。詳情請參閱「使用智慧型方塊預覽連結」。

createActionTriggers[]

object (CreateActionExtensionPoint)

這裡列出了在 Google Workspace 應用程式中建立第三方資源的擴充點。詳情請參閱「使用 @ 選單建立第三方資源」。

DocsExtensionPoint

用於宣告文件外掛程式觸發條件的常見格式。

JSON 表示法
{
  "runFunction": string
}
欄位
runFunction

string

必要欄位。啟用這個擴充點時要執行的端點。

LinkPreviewExtensionPoint

當使用者輸入第三方或非 Google 服務的連結,或將連結貼到 Google 文件、試算表或簡報檔案中,觸發條件設定就會觸發。

JSON 表示法
{
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "patterns": [
    {
      object (UriPattern)
    }
  ],
  "runFunction": string,
  "logoUrl": string
}
欄位
labelText

string

必要欄位。智慧型方塊範例的文字,提示使用者預覽連結,例如 Example: Support case。這段文字是靜態的,會在使用者執行外掛程式之前顯示。

localizedLabelText

map (key: string, value: string)

選用設定。用於翻譯成其他語言的 labeltext 對應。請使用 ISO 639 格式和 ISO 3166 格式的國家/地區設定語言,並以連字號 - 分隔。例如 en-US

如果地圖的鍵中含有使用者的語言代碼,使用者就會看到 labeltext 的本地化版本。

這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

patterns[]

object (UriPattern)

必要欄位。觸發預覽連結外掛程式的網址模式陣列。

runFunction

string

必要欄位。觸發連結預覽時要執行的端點。

logoUrl

string

選用設定。智慧型方塊和預覽資訊卡中的圖示。如果省略此資訊,外掛程式會使用工具列圖示 logourl

UriPattern

每個會觸發連結預覽的網址模式設定。

JSON 表示法
{
  "hostPattern": string,
  "pathPrefix": string
}
欄位
hostPattern

string

必須為每個要預覽的網址格式設定。網址模式的網域。外掛程式預覽連結的網址會包含該網域。如要預覽特定子網域 (例如 subdomain.example.com) 的連結,請加入子網域。如要預覽整個網域的連結,請指定萬用字元並以星號 (*) 做為子網域。

舉例來說,*.example.com 符合 subdomain.example.comanother.subdomain.example.com

pathPrefix

string

選用設定。附加 hostpattern 網域的路徑。

舉例來說,如果網址主機模式是 support.example.com,如要比對由 support.example.com/cases/ 代管的案件網址,請輸入 cases

如要比對主機模式網域中的所有網址,請將 pathprefix 留空。

CreateActionExtensionPoint

這項觸發條件設定會在使用者於 Google Workspace 應用程式中叫用資源建立工作流程時觸發。詳情請參閱「使用 @ 選單建立第三方資源」。

JSON 表示法
{
  "id": string,
  "labelText": string,
  "localizedLabelText": {
    string: string,
    ...
  },
  "runFunction": string,
  "logoUrl": string
}
欄位
id

string

必要欄位。用來區分這個延伸點的專屬 ID。ID 長度上限為 64 個半形字元,且格式應為 [a-zA-Z0-9-]+

labelText

string

必要欄位。顯示在資源建立進入點圖示 (例如 Create support case) 旁的文字。這段文字是靜態的,會在使用者執行外掛程式之前顯示。

localizedLabelText

map (key: string, value: string)

選用設定。用於翻譯成其他語言的 labeltext 對應。請使用 ISO 639 格式和 ISO 3166 格式的國家/地區設定語言,並以連字號 - 分隔。例如 en-US

如果地圖的鍵中含有使用者的語言代碼,使用者就會看到 labeltext 的本地化版本。

這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

runFunction

string

必要欄位。資源建立工作流程被觸發以建立連結時要執行的端點。

logoUrl

string

選用設定。顯示資源建立進入點的圖示。如果省略此資訊,選單會使用外掛程式的工具列圖示 logourl

SheetsAddOnManifest

用來自訂 Google 試算表外掛程式外觀和執行方式的屬性。

JSON 表示法
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SheetsExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ]
}
欄位
homepageTrigger

object (HomepageExtensionPoint)

如有的話,這會覆寫 addons.common.homepageTrigger 的設定。

onFileScopeGrantedTrigger

object (SheetsExtensionPoint)

授予此文件/使用者組合的檔案範圍授權時,要執行的端點。

linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

在 Google 試算表文件中預覽連結的擴充點清單。詳情請參閱「使用智慧型方塊預覽連結」。

SheetsExtensionPoint

宣告試算表外掛程式觸發條件的常見格式。

JSON 表示法
{
  "runFunction": string
}
欄位
runFunction

string

必要欄位。啟用這個擴充點時要執行的端點。

SlidesAddOnManifest

為 Google 簡報外掛程式自訂外觀和執行方式的屬性。

JSON 表示法
{
  "homepageTrigger": {
    object (HomepageExtensionPoint)
  },
  "onFileScopeGrantedTrigger": {
    object (SlidesExtensionPoint)
  },
  "linkPreviewTriggers": [
    {
      object (LinkPreviewExtensionPoint)
    }
  ]
}
欄位
homepageTrigger

object (HomepageExtensionPoint)

如有的話,這會覆寫 addons.common.homepageTrigger 的設定。

onFileScopeGrantedTrigger

object (SlidesExtensionPoint)

授予此文件/使用者組合的檔案範圍授權時,要執行的端點。

linkPreviewTriggers[]

object (LinkPreviewExtensionPoint)

在 Google 簡報文件中預覽連結的擴充點清單。詳情請參閱「使用智慧型方塊預覽連結」。

SlidesExtensionPoint

用於宣告簡報外掛程式觸發條件的常見格式。

JSON 表示法
{
  "runFunction": string
}
欄位
runFunction

string

必要欄位。啟用這個擴充點時要執行的端點。

HttpOptions

傳送要求至外掛程式 HTTP 端點的選項。

JSON 表示法
{
  "authorizationHeader": enum (HttpAuthorizationHeader)
}
欄位
authorizationHeader

enum (HttpAuthorizationHeader)

透過 HTTP 授權標頭傳送的憑證設定。

HttpAuthorizationHeader

透過外掛程式 HTTP 要求傳送 Authorization 標頭。

列舉
HTTP_AUTHORIZATION_HEADER_UNSPECIFIED 預設值,相當於 SYSTEM_ID_TOKEN
SYSTEM_ID_TOKEN 針對專案專屬的 Google Workspace 外掛程式系統服務帳戶 (預設) 傳送 ID 權杖。
USER_ID_TOKEN 傳送使用者的 ID 權杖。
NONE 請勿傳送驗證標頭。

方法

create

使用指定的名稱和設定建立部署作業。

delete

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

get

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

getInstallStatus

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

install

在帳戶中安裝部署作業來進行測試。

list

列出特定專案中的所有部署作業。

replaceDeployment

以指定名稱建立或取代部署作業。

uninstall

從使用者的帳戶解除安裝測試部署作業。