日曆資訊清單資源

用來定義下列項目的資源設定 Google Workspace 外掛程式 「Google 日曆」中的內容和行為。 Google Workspace 外掛程式資訊清單必須具備 如果元件擴充了日曆,則標示為必要的所有元件。

日曆

應用程式的 Google Workspace 外掛程式資訊清單設定 Google 日曆擴充功能。 請參閱「使用 Google Workspace 外掛程式擴充 Google 日曆」 瞭解詳情

JSON 表示法
{
  "createSettingsUrlFunction": string,
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "currentEventAccess": string,
  "eventOpenTrigger": {
    object (EventOpenTrigger)
  },
  "eventUpdateTrigger": {
    object (EventUpdateTrigger)
  },
  "eventAttachmentTrigger": {
    object (EventAttachmentTrigger)
  },
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
欄位
createSettingsUrlFunction

string

僅適用於外掛程式提供以下功能的情況 會議解決方案 選用設定。產生網址的 Apps Script 函式名稱 將對方帶往該外掛程式的設定頁面。

請參閱 新增會議通訊外掛程式設定,瞭解詳情。
conferenceSolution[]

object (ConferenceSolution)

僅適用於外掛程式提供以下功能的情況 會議解決方案;如果有,至少須提供一項解決方案 定義。 外掛程式提供的會議解決方案清單。每項解決方案 在 Google 日曆的「編輯活動」使用者介面。
currentEventAccess

string

決定外掛程式對使用者產生資料的存取權層級 事件資料。如未提供,系統不會將事件中繼資料傳遞至 外掛程式。 有效的設定如下:

  • METADATA:表示外掛程式只能存取 基本事件中繼資料
  • READ 表示外掛程式可以讀取使用者產生的 事件資料。
  • WRITE 表示外掛程式可以寫入 使用者產生的事件資料
  • READ_WRITE 表示外掛程式可以讀取及寫入 使用者產生的事件資料,以及讀取基本中繼資料。

如果設為 READREAD_WRITE,系統就會採用外掛程式 必須具備 https://www.googleapis.com/auth/calendar.addons.current.event.read scope

如果設為 WRITEREAD_WRITE,則外掛程式必須 提供 https://www.googleapis.com/auth/calendar.addons.current.event.write 範圍

eventOpenTrigger

object (EventOpenTrigger)

Google 日曆中活動開啟觸發條件的觸發條件規格。

eventUpdateTrigger

object (EventUpdateTrigger)

如要在 Google 中提供結構定義事件更新介面,此為必要欄位 日曆。事件更新觸發條件的觸發條件規格: 日曆。

eventAttachmentTrigger

object (EventAttachmentTrigger)

日曆中活動附件觸發條件的觸發條件規格。

homepageTrigger

object (HomepageTrigger)

用於建立外掛程式的觸發函式規格 首頁 日曆主辦人。這會覆寫 addOns.common.homepageTrigger

ConferenceSolution

應用程式的設定 會議解決方案 外掛程式提供的工具每項解決方案都有對應的會議選項 也就是 Google 日曆的「編輯活動」使用者介面。

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

string

必填。會議解決方案的 ID。必須為 個別的會議解決方案 ID 一經選取即無法變更。
logoUrl

string

代表解決方案的圖示連結。 圖片尺寸應調整為 96 x 96 dp。

不得為任意網址,圖片必須存放在 Google 的 基礎架構詳情請見 提供會議解決方案標誌,以瞭解詳細資訊。

如有提供,該圖像可能與 外掛程式 calendar.logoUrl,也就是用來呈現 附加在其擴充的主機應用程式中如果標誌圖片並非 針對特定解決方案提供的工具 而是使用 calendar.logoUrl
name

string

必填。會議解決方案的名稱,列於 Google 日曆 UI;使用者建立或編輯活動時。
onCreateFunction

string

必填。呼叫的 Apps Script 函式名稱 Google 日曆會嘗試建立這類會議。您必須 為每個會議解決方案實作這個函式 以及您的外掛程式是否支援

EventOpenTrigger

情境觸發條件的設定,會在 Google 日曆上觸發 事件。詳情請見 擴充日曆活動介面 瞭解詳情

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

string

Apps Script 函式的名稱,會在使用者開啟 用於查看或編輯的日曆活動。指定時,您必須 這個函式會建立並傳回 Card敬上 要在外掛程式 UI 中顯示的物件。

EventUpdateTrigger

情境觸發條件的設定,會在 Google 日曆上觸發 使用者編輯並儲存事件詳情請見 更新日曆活動 瞭解詳情

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

string

Apps Script 函式的名稱,會在使用者編輯和編輯時 儲存日曆活動。如有指定,則必須實作此函式 建構並傳回 Card敬上 要在外掛程式 UI 中顯示的物件。

EventAttachmentTrigger

內容相關觸發條件的設定,會在使用者點擊 外掛程式附件提供者。

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

string

必要。Apps Script 函式在 使用者在日曆下拉式選單中選取外掛程式附件提供者 或前往 Google 試算表選單您必須實作此函式,以建構並傳回 Card敬上 要在外掛程式 UI 中顯示的物件。
label

string

必要。日曆下拉式選單中顯示的文字 識別該連結提供者。