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

• 您可以在說明中找到與應用程式通訊的按鈕。
• 應用程式名稱開頭為 A 到 Z (大寫) 或 0 到 9。開頭不得為符號。

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

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

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

• 應用程式具有清晰可辨識的顯示圖片。

• 應用程式不會使用 Chrome 瀏覽器擴充功能，直接操控 Google 雲端硬碟 HTML 來提供功能。
• 如果應用程式使用機密或受限制範圍，則必須通過 OAuth 驗證。請參閱「如何送交驗證」。
• 如果您的應用程式使用受限制的範圍，就必須接受安全性評估。請參閱「為什麼需要進行安全性評估」。

• 如果應用程式會將檔案儲存在雲端硬碟中，則可讓使用者選擇資料夾，或建立並重複使用應用程式專屬資料夾。設定資料可儲存在應用程式資料資料夾中。應用程式不會將檔案轉存到使用者的「我的雲端硬碟」資料夾。
• 應用程式只會在雲端硬碟中儲存與應用程式已記錄功能相關的檔案。

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

• 這個外掛程式提供所有必要資訊，讓您能對產品和使用方式有基本瞭解。
• 外掛程式程式碼不會過度使用程式庫，因為程式庫可能會導致外掛程式效能降低。
• 盡可能避免錯誤並妥善管理，如果無法避免，請採取以下做法：
  • 錯誤訊息會顯示在對話方塊中，而非 JavaScript 快訊或預設紅色列上。他們會以簡單的語言說明問題，並說明使用者必須採取哪些行動才能解決問題。
  • 如果使用者操作不當，系統會盡可能顯示按鈕，讓使用者自行修正問題。
  • 詳情請參閱 外掛程式樣式指南。
• 外部網頁連結會在新視窗中開啟，且正確無誤。
• 這項外掛程式設計直覺，這表示：
  • 您總是能清楚瞭解要做什麼和如何做。
  • 這個外掛程式易於使用且易於理解。避免使用專業術語和專門用語。
  • 盡可能提供清晰的工作流程，並盡可能簡化流程。
  • 使用者和他們的內容盡可能安全。
• 這個外掛程式遵循 編輯器外掛程式的 UI 樣式指南，並使用 編輯器外掛程式的 CSS 套件。
• 外掛程式每個螢幕只使用一個藍色主要動作。
• 外掛程式一次只會顯示一個對話方塊。不會重疊或同時開啟多個對話方塊。
• 外掛程式的使用者介面可完美地容納在指定空間中：
  • 文字和標籤不會以「...」截斷
  • 使用者不必捲動畫面太多。
  • 內容寬度不會超過 300p，因此不會顯示水平捲軸。
• 對於所有敏感動作，外掛程式都會要求確認或顯示警告。舉例來說，如果外掛程式即將覆寫試算表中的所有內容，系統會發出警告，並在執行前要求使用者確認。

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

• 使用者無法在動作載入期間多次觸發動作。例如，在載入動作時，按鈕會關閉或隱藏。

日曆外掛程式

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

• 外掛程式會使用正確的 Widget (或 Meet 外掛程式中的 iframed UI) 提供所需功能。例如，使用切換按鈕選取布林值。

日曆外掛程式

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

Gmail 外掛程式

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

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

Meet 外掛程式

• 即使停用第三方 Cookie，外掛程式登入和使用者歷程也必須正常運作。
• 外掛程式必須提供與會議運作或參與相關的功能。
• 外掛程式不得執行任何會讓使用者離開會議的動作，例如重新整理瀏覽器。
• 如果使用多玩家體驗，即使未事先設定權限，外掛程式也必須允許所有參與者共同編輯內容。協作式外掛程式工作階段必須提供權限調整功能。
• 外掛程式必須處理啟動活動流程的取消作業，並允許使用者從應用程式重新啟動活動。
• 外掛程式必須提供側邊面板，供使用者登入及設定活動體驗。
• 外掛程式不得提供邀請機器人的功能，或依賴機器人是否在會議中

• 外掛程式有首頁。如果 Google Workspace 外掛程式是轉換的 Gmail 外掛程式，系統會套用預設的首頁。
• 外掛程式資訊卡 (或 Meet 外掛程式中的 iframed UI) 正常運作。舉例來說，系統不會顯示重複項目，返回、重新整理和更新按鈕也會正常運作。
• 使用者授權外掛程式後，系統會顯示自訂的首頁資訊卡 (Meet 外掛程式中的網頁)，歡迎使用者使用外掛程式，並提供登入按鈕 (如有需要)、標誌和外掛程式的簡短說明。
  • 如果系統觸發登入按鈕，就會顯示第三方供應商提供的客製化登入頁面，清楚指出 Google Workspace 以外的第三方服務。
• 外掛程式的使用者介面可完美地容納在指定空間中：
  • 文字和標籤不會以「…」截斷
  • 使用者不必大幅捲動畫面。
  • 內容寬度不會超過 300p，因此不會顯示水平捲軸。
• 外掛程式的程式碼不會過度使用程式庫，因為程式庫可能會導致外掛程式效能降低。

日曆外掛程式

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

Google 文件外掛程式

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

• 連結預覽可為使用者提供相關的補充資訊。舉例來說，預覽銷售交易連結時，系統會加入帳戶、金額和階段等資訊。
• 開發人員與預覽的網域有關係。

詳情請參閱「使用智慧型方塊預覽連結」。

雲端硬碟外掛程式

• 如果應用程式會將檔案儲存在雲端硬碟中，則可讓使用者選擇資料夾，或建立並重複使用應用程式專屬資料夾。設定資料可儲存在應用程式資料資料夾中。應用程式不會將檔案轉存到使用者的「我的雲端硬碟」資料夾。
• 外掛程式只會在雲端硬碟中儲存與外掛程式已記錄功能相關的檔案。

Gmail 外掛程式

• 外掛程式未提及或連結 Chrome 瀏覽器擴充功能，且未說明原因。
• 「更多動作」選單 more_vert 包含正常運作的通用動作。例如「登出」、「關於」和「支援」等。

Meet 外掛程式

• 如果外掛程式需要授權或訂閱：當使用者沒有授權時，必須向使用者顯示友善訊息。
• 如果使用者因授權問題而無法使用外掛程式，則錯誤訊息必須清楚說明無法使用外掛程式的原因，並建議使用者採取哪些行動來解決問題。
• 外掛程式的 Google Workspace Marketplace 產品資訊必須明確列出使用外掛程式時可能需要的授權和訂閱要求。如果外掛程式有付費方案，市集產品資訊必須提供網頁連結，讓使用者進一步瞭解價格或聯絡業務人員的方式。
• 如果使用者尚未登入，外掛程式必須顯示「顯示 Google One Tap」中的 One Tap 登入提示，以及「驗證」中的「使用 Google 帳戶登入」備用選項。除了「使用 Google 帳戶登入」機制外，您可能還會看到其他登入選項。
• 外掛程式必須採用回應式設計，才能根據不同大小調整內容。
• 即使停用第三方 Cookie，外掛程式使用者歷程也必須正常運作。
• 外掛程式不得在 iframe 中橫向捲動。
• 如果外掛程式要使用主畫面，就必須針對多人遊戲體驗設計，並允許多位參與者同時操作內容。開發人員應使用側邊面板，提供單人遊戲體驗。
• (建議) 外掛程式應顯示已登入使用者的身分。
• (建議) 本地化選項：語言應根據瀏覽器設定的本地偏好設定 (如有)。
• (建議) 內容選取應透過內容瀏覽介面進行，並顯示最近存取的內容。
• (建議) 如果不再需要側邊面板，外掛程式應在啟動至主畫面後關閉側邊面板。

日曆外掛程式

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

Meet 外掛程式

• 外掛程式的品牌標誌大小和樣式必須符合 Meet 側邊面板的識別需求。
• 必須在外掛程式資訊清單中指定適當的深色模式標誌網址

雲端硬碟外掛程式

• (建議) 如果您想要接收有限的中繼資料，附加功能就會包含 drive.addons.metadata.readonly 範圍。

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