日曆資訊清單資源

資源設定用於定義 Google 日曆中的 Google Workspace 外掛程式內容和行為。如果 Google Workspace 外掛程式擴充了 Google 日曆，外掛程式資訊清單就必須包含所有標示為「必要」的元件。

日曆

日曆擴充功能的 Google Workspace 外掛程式資訊清單設定。詳情請參閱「使用 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)

只有在外掛程式提供 會議解決方案時才使用；必須定義至少一個解決方案。 外掛程式提供的會議解決方案。每項解決方案都會顯示在日曆的「編輯活動」使用者介面中。
currentEventAccess

string

決定外掛程式對活動資料的存取層級。如果省略，主辦人不會傳遞活動中繼資料。 有效設定包括：

  • METADATA：存取基本活動中繼資料。
  • READ：讀取事件資料和中繼資料的存取權。
  • WRITE：寫入事件資料的存取權。
  • READ_WRITE：讀取及寫入事件資料和中繼資料的存取權。

如果設為 READ 或 READ_WRITE，外掛程式必須包含 https://www.googleapis.com/auth/calendar.addons.current.event.read scope。

如果設為 WRITE 或 READ_WRITE，外掛程式必須包含 https://www.googleapis.com/auth/calendar.addons.current.event.write scope。
eventOpenTrigger

object (EventOpenTrigger)

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

object (EventUpdateTrigger)

必須提供日曆中的情境式活動更新介面。事件更新觸發條件的觸發條件規格。
eventAttachmentTrigger

object (EventAttachmentTrigger)

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

object (HomepageTrigger)

外掛程式的觸發函式，位於 Google 日曆的首頁。這會覆寫 addOns.common.homepageTrigger。

ConferenceSolution

只有使用第三方會議解決方案擴充 Google 日曆的外掛程式，才需要這個資訊清單物件。

外掛程式提供的會議解決方案設定。每項解決方案都會顯示在 Google 日曆的「編輯活動」使用者介面中。

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

string

必填。會議解決方案的 ID。會議解決方案組合中的每個 ID 不得重複。選擇 ID 後請勿變更。
logoUrl

string

解決方案圖示的連結。圖片大小應為 96 x 96 dp。

圖片必須託管在 Google 基礎架構上。詳情請參閱「 提供會議解決方案標誌」。

這張圖片可能與外掛程式 calendar.logoUrl 顯示的圖片不同。如果省略特定解決方案的這項設定，指令碼會使用 calendar.logoUrl。
name

string

必填。Google 日曆使用者介面中顯示的會議解決方案名稱。
onCreateFunction

string

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

EventOpenTrigger

使用者開啟 Google 日曆活動時觸發的內容觸發條件設定。詳情請參閱「擴充 Google 日曆活動介面」。

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

string

使用者開啟日曆活動時執行的 Apps Script 函式名稱。函式必須傳回 UI 的 Card 物件陣列。

EventUpdateTrigger

當使用者編輯並儲存 Google 日曆活動時，系統會觸發內容相關觸發條件的設定。詳情請參閱「更新日曆活動」。

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

string

使用者儲存編輯後的日曆活動時執行的 Apps Script 函式名稱。函式必須傳回 UI 的 Card 物件陣列。

EventAttachmentTrigger

內容觸發條件的設定，使用者在日曆選單中選取外掛程式附件供應商時，就會觸發該條件。

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

string

必要。使用者選取供應商時執行的 Apps Script 函式名稱。函式必須傳回 UI 的 Card 物件陣列。
label

string

必要。識別附件供應商的選單文字。