Google Workspace Marketplace 的應用程式審查程序和規定

• 說明中會提供與應用程式通訊的按鈕。
• 應用程式名稱的開頭為 A—Z (大寫) 或 0–9。且開頭不得為符號。

• 每當使用者發起即時訊息或將應用程式新增至聊天室時，應用程式就會傳送未提示的歡迎訊息。歡迎訊息與「Help」指令不同。詳情請參閱「 傳送應用程式首頁資訊卡訊息」。
• 應用程式支援「說明」指令，並協助使用者開始使用應用程式。詳情請參閱「 回應斜線指令」。
• 當應用程式在聊天室或即時通訊中有人說話時，應用程式一律會回應。
• 訊息使用正確的拼字、大小寫、標點符號和文法。訊息中不得包含惡意、令人反感或不當的內容。
• 根據 Google 的規定，訊息會使用清晰、簡潔且一致的格式。
• 如果回應時間超過 2 秒，應用程式就會傳送說明延遲的訊息。
• 可傳送通知的應用程式可讓使用者關閉通知功能。
• 使用者可以使用 @號提及他人，將應用程式加入聊天室。
• 使用者可使用「查看成員」選單，將應用程式從聊天室中移除。
• 應用程式會向使用者傳達與其互動所需的所有資訊。
• 應用程式使用的卡片格式符合 Google 的規定。請參閱 建立互動式資訊卡。
• 透過 Chat 選單中的「尋找應用程式」選項，即可找到此應用程式。
• 應用程式互動的外部網址不屬於測試或開發環境。
• 在聊天室中傳送給應用程式的每則訊息都必須使用 @號提及他人。這是應用程式知道必須回應的唯一方式。
• 如果 Chat 應用程式預覽來自第三方網域的連結：
  • 連結預覽在使用者的訊息中提供了相關的補充資訊。例如，預覽銷售交易的連結可以加入帳戶、金額和階段等資訊。
  • 開發人員已與預覽網域建立關聯。

  詳情請參閱「預覽連結」。

• (建議做法) 如要讓 Workspace 管理員代表機構中的使用者安裝應用程式，您的應用程式必須能夠接收及傳送即時訊息。

• 應用程式顯示明確且易於辨識的顯示圖片。

• 應用程式未透過 Chrome 瀏覽器擴充功能直接操控雲端硬碟 HTML 來提供功能。
• 如果您的應用程式使用敏感或受限制的範圍，就必須通過 OAuth 驗證。請參閱如何提交驗證申請一節。
• 如果您的應用程式使用受限制的範圍，也必須通過安全性評估。請參閱為什麼需要進行安全性評估。

• 如果應用程式將檔案儲存在雲端硬碟，使用者就能選擇資料夾，或是建立並重複使用應用程式特定資料夾。設定資料可儲存在「應用程式資料」資料夾中。應用程式不會將檔案轉儲到使用者的「我的雲端硬碟」資料夾。
• 應用程式只會將連結至應用程式記錄功能的雲端硬碟檔案儲存至雲端硬碟。

• 外掛程式包含預期和必要動作，其中包含完成工作流程所需的所有工具。例如：
  • 如果外掛程式將樣式套用至整份文件，則可選擇僅將樣式套用至所選文字。
  • 如果外掛程式將試算表資料上傳至網路服務動態饋給，便會提供該動態饋給的連結，方便您瀏覽。
  • 如果外掛程式要求使用者建立帳戶，則會提供連結或資訊，以便在使用者沒有帳戶時輕鬆建立帳戶。
• 外掛程式的「外掛程式」分頁下方會有選單項目。
• 即使外掛程式只是自訂函式，仍包含適當的說明文件。
• 外掛程式可正確使用 onInstall() 和 onOpen() 填入選單。系統會在首次安裝外掛程式和開啟不同檔案時填入選單項目。請參閱 編輯器外掛程式授權。
• 已正確設定授權模式。請參閱「 授權模式」一文。

• 這個外掛程式提供所有必要資訊，以對產品有基本瞭解及其使用方式。
• 外掛程式程式碼不會過度使用程式庫，因為程式庫可能會導致外掛程式效能降低。
• 盡量避免錯誤，如果不行的話，妥善管理：
  • 錯誤訊息會顯示在對話方塊視窗中，而非 JavaScript 快訊或預設紅色列。他們會以簡單的用語說明問題，並說明使用者必須採取哪些行動。
  • 如果可以，如果使用者操作發生錯誤，系統會顯示按鈕，方便使用者修正問題。
  • 詳情請參閱 外掛程式樣式指南。
• 系統會在新視窗中開啟外部網頁連結，而且網頁正確無誤。
• 外掛程式符合直覺且設計完善。因此：
  • 不論是做什麼還是方法，都顯得明確易懂。
  • 外掛程式易於使用且易於理解。避免使用相關術語和術語。
  • 並盡可能清楚易懂工作流程。
  • 盡可能確保使用者及其內容安全無虞。
• 這個外掛程式遵循 編輯器外掛程式的 UI 樣式指南，並使用 適用於編輯器外掛程式的 CSS 套件。
• 外掛程式在每個螢幕上只會使用一個藍色主要動作。
• 外掛程式一次顯示一個對話方塊。不會重疊，或一次開啟多個對話方塊。
• 外掛程式的 UI 能整齊分配在分配的空間中：
  • 文字與標籤不會因為含有「...」符號遭到截斷
  • 使用者不必進行太多垂直捲動。
  • 內容寬度不會超過 300p，因此沒有水平捲軸。
• 外掛程式需要確認，或針對所有敏感動作顯示警告。舉例來說，如果外掛程式即將覆寫試算表中的所有內容，系統會發出警告，並在使用者發生前確認動作。

  您可以透過設計變更避免這項規定。舉例來說，如果使用 Google 試算表外掛程式匯入資料，就會有覆寫現有內容的風險。您可以為資料建立工作表做為預設動作，藉此移除風險。

• 使用者在載入動作時無法多次觸發動作。舉例來說，在載入動作時停用或隱藏按鈕。

日曆外掛程式

• 如果外掛程式使用 calendar.name 或 common.name，則資訊清單中的名稱會與應用程式資訊中提供的名稱相同。
• 如果外掛程式使用 calendar.conferenceSolution，會議解決方案名稱中就不會包含「Google 日曆」。
• (建議) 如果外掛程式使用 calendar.conferenceSolution，會議解決方案名稱長度不得超過 30 個字元。

• 外掛程式會使用正確的 小工具來提供所需功能。例如，使用切換按鈕選取布林值。

日曆外掛程式

• 系統支援次要日曆和委派，如果不支援，則能優雅管理。舉例來說，如果使用者在建立活動時選取其他具備編輯權限的日曆，會議建立作業並不會失敗。
• 週期性活動可以正常運作。
• 如果外掛程式使用 calendar.conferenceSolution，則至少會提供一項會議解決方案。
• 如果外掛程式提供會議解決方案，系統會使用適當的會議資料欄位。舉例來說，視訊會議連結、電話號碼、SIP 連結、存取碼和其他支援的屬性會使用結構化資料欄位，因此記事欄位不會提供這些屬性。
• 如果外掛程式提供會議解決方案，則只會編輯會議詳細資料，沒有其他活動欄位。
• 如果外掛程式提供會議解決方案，則可在 5 秒內建立會議。

Gmail 外掛程式

如果外掛程式使用 UrlFetchApp 或 OpenLinkUrl：

• 網址有效。
• 網址使用 HTTPS 而非 HTTP。
• 已指定完整網域。
• 路徑並非空白。例如可以使用 https://altostrat/，但 https://altostrat 不行。
• 無法在UrlFetchApp中使用萬用字元。

• 外掛程式有首頁。如果 Google Workspace 外掛程式是轉換後的 Gmail 外掛程式，系統會套用預設的首頁。
• 外掛程式資訊卡可正常運作。舉例來說，沒有重複的資訊卡；返回、重新整理和更新按鈕可據此運作。
• 使用者授權外掛程式後，畫面上會顯示自訂首頁資訊卡，歡迎使用者點選登入按鈕 (如有需要)、標誌和外掛程式簡短說明。
  • 如果觸發登入按鈕，系統會顯示第三方供應商的自訂登入頁面，清楚指出其中有非 Google Workspace 使用的第三方服務。
• 外掛程式的 UI 能整齊分配在分配的空間中：
  • 文字和標籤不會因為「...」而遭截斷
  • 使用者不用進行太多垂直捲動。
  • 內容寬度不會超過 300p，因此沒有水平捲軸。
• 外掛程式的程式碼不常使用程式庫，因為程式庫可能會導致外掛程式效能下降。

日曆外掛程式

• 如果外掛程式提供會議解決方案，已建立的會議會生效，並正確顯示在第三方會議網站上。

文件外掛程式

如果外掛程式的預覽畫面來自第三方網域 (智慧型方塊) 的連結：

• 連結預覽可以為使用者提供相關的補充資訊。例如，預覽銷售交易的連結可以加入帳戶、金額和階段等資訊。
• 開發人員已與預覽網域建立關聯。

詳情請參閱「預覽含有智慧型方塊的連結」一文。

雲端硬碟外掛程式

• 如果應用程式將檔案儲存在雲端硬碟，使用者就能選擇資料夾，或是建立並重複使用應用程式特定資料夾。設定資料可儲存在「應用程式資料」資料夾中。應用程式不會將檔案轉儲到使用者的「我的雲端硬碟」資料夾。
• 這個外掛程式只會將與外掛程式所列功能相關聯的檔案儲存至雲端硬碟。

Gmail 外掛程式

• 外掛程式不會在沒有理由的情況下提及或連結至 Chrome 瀏覽器擴充功能。
• 「更多動作」選單more_vert包含可正常運作的通用動作。例如登出、關於、支援等。

日曆外掛程式

• 會議解決方案的標誌為公開網址。詳情請參閱「 提供會議解決方案標誌」。
• 如果外掛程式使用 calendar.conferenceSolution，則會議解決方案的標誌必須符合 calendar.logoUrl 的規定。請參閱「 日曆資訊清單資源」。
• 如果外掛程式使用 calendar.logoUrl 或 common.logoUrl，則標誌與應用程式資訊中提供的圖示相同。
• 如果外掛程式使用 calendar.logoUrl 或 common.logoUrl，標誌網址開頭如下：https://lh3.googleusercontent.com/

雲端硬碟外掛程式

• (建議) 如要接收有限的中繼資料，這個外掛程式會包含 drive.addons.metadata.readonly 範圍。

• 通用導覽網址會指向網頁應用程式。如果沒有功能的簡單網頁，則不屬於網頁應用程式。