合作夥伴連接器需求

請參閱「發布總覽」，瞭解發布連接器的優點和規定等級。如要發布合作夥伴連接器，您的連接器必須符合下列所有需求條件。

Apps Script

將連接器送審前，請在 Apps Script 中完成下列步驟：

  1. 共用 Apps Script 專案的檢視權限，步驟如下：
  2. 建立部署作業並命名為 Production，並將 Production 部署更新為您要發布的程式碼版本。
  3. 確認您已將 Production 部署作業更新為要查看的程式碼版本。
  4. 確認資訊清單檔案顯示在 Apps Script 中。按一下左側的「Project Settings」圖示 。選取「在編輯器中顯示「appsscript.json」資訊清單檔案」核取方塊。

資訊清單

請在連接器資訊清單中加入以下內容，並確認 Apps Script 專案已設為在編輯器中顯示 appsscript.json 資訊清單檔案。

詳情請參閱社群連接器資訊清單參考資料。

dataStudio

  1. description 應提供相關資訊與操作說明，協助您基本瞭解連接器及其使用方式。如果連接器含有模糊不清且說明不完整的連接器，則遭到拒絕。
  2. addOnUrl 應為與您連接器相關的專屬代管頁面，最好是在您自己的網域上代管。網頁必須包括下列項目：
    • 「隱私權政策」和「使用條款」，或者位於與 addOnUrl 相同的網域上，提供此內容的連結。
    • 使用者必須知道才能使用您的連接器所需的詳細資料。
    • 如果必須透過帳戶才能使用您的連接器，請提供註冊連結。
    • 最好透過您的網域代管內容。不允許託管於 https://sites.google.com/。
    • 請參閱現有合作夥伴的範例網頁：Funnel、Supermetrics、CallRail。
  3. supportUrl 應為託管頁面，以取得連接器支援。此連結不得為電子郵件或 mailto 連結。
  4. logoUrl 應指向由您控管的靜態圖片。您無法在 *.gstatic.com、*.ggpht.com、*.google.com、*.googleusercontent.com 等網域上使用 Google 服務提供的映像檔。我們接受使用 Google Cloud Storage 從 *.googleapis.com 網域提供圖片，因此建議您採用託管選項。
    • 系統會拒絕含有動畫圖示的連接器。使用靜態圖片。
    • 建議至少使用 48 x 48 像素的圖片。
    • 避免在縮小為 48x48 像素時難以閱讀的僅限文字圖片。
  5. 使用連接器連線的所有來源填入 sources 屬性。詳情請參閱「資訊清單參考資料中的來源」一節。
    • 您可以在資料登錄存放區中查看現有的來源清單。如果您連線的來源不在存放區中，請傳送提取要求至 Data Registry 存放區以新增來源。如果存放區中沒有資訊清單中的來源，則連接器會失敗審查程序。
    • 這是連接器的其他中繼資料，用於為圖片庫中的搜尋功能建立索引。當使用者在範本庫中搜尋特定來源時，連接器就會顯示您的連接器。
  6. 請提供 shortDescription、authType、feeType、privacyPolicyUrl 和 termsOfServiceUrl 的值。
  7. name 應直接代表連接器的用途。清楚的名稱能幫助使用者判斷您的連接器是否符合需求。請勿在名稱中使用「連接器」字詞，因為使用者知道他們正在查看連接器。
    • 請勿加入特殊或隱形字元，意圖引起關注或可能改變連接器位置。
  8. 請勿在資訊清單中的任何位置 (例如 GDS、DS 等) 使用 Looker Studio 的簡稱。
  9. 任何資訊清單欄位 (description、shortDescription、name 等) 都不允許使用表情符號。一般而言，請勿加入特殊或隱形字元，意圖吸引使用者註意連接器。
  10. 如果您的連接器有固定的結構定義，請為連接器建立報表範本並新增至資訊清單。啟用報表的「透過連結分享」。

urlFetchWhitelist

  1. 將 UrlFetchApp 呼叫的端點數量限制為絕對需要連接器功能所需的端點。將 urlFetchWhitelist 屬性新增至資訊清單的根層級。詳情請參閱 urlFetchWhitelist 參考資料。
    • 納入與 UrlFetchApp 服務搭配使用的所有端點。
    • 如果連接器未使用 UrlFetchApp 服務擷取資源，請將 urlFetchWhitelist 設為空白清單 []。
    • 如果您的連接器未連線至一組固定端點，或端點的前置字串各不相同，請省略 urlFetchWhitelist 屬性，並在提交審查要求時，在「Exception for urlFetchWhitelist」表單欄位中提供詳細資料。

oauthScopes

  1. 在資訊清單中設定明確的 OAuth 範圍。系統會拒絕沒有明確 OAuth 範圍的連接器。

連接線

  1. 如果使用者需要帳戶才能使用連接器，請確認連接器 description 或 addOnUrl 連結會提供操作說明，協助使用者建立連接器。
  2. 連接器無法處於未完成或 Beta 版狀態。您必須發布完整且功能齊全的連接器。您隨時可以更新連接器，但發布給使用者的實際工作環境部署應經過測試及完成。
  3. 當使用者遇到連接器內部錯誤時，提供實際且可行的錯誤訊息。這包括使用者在設定中提供無效/空白輸入內容的情況。
  4. shortDescription、description、addOnUrl 連結、supportUrl 連結和 OAuth 頁面 (如適用) 不應有拼字和文法錯誤。
  5. shortDescription 不能包含網址。
  6. 使用 getAuthType() 提供的驗證方法。請勿透過 getConfig() 要求憑證。
  7. 完成 OAuth 用戶端驗證程序。無論 getAuthType() 中的驗證方法為何，所有連接器都必須進行驗證。驗證程序與連接器審查作業不同，由獨立的團隊負責處理，而非 Looker Studio。詳情請參閱 OAuth API 驗證常見問題。如果 OAuth 用戶端驗證程序未完成，您的連接器會遭到拒絕。
    • 在 OAuth 驗證程序中，請在 OAuth 同意畫面設定中新增連接器所需的 OAuth 範圍。如果您無法新增「所有」必要的範圍，您可能會通過 OAuth 驗證程序，但連接器仍會顯示「未驗證的應用程式」畫面。這會導致合作夥伴連接器驗證程序失敗。
      完成 OAuth 驗證程序後，請使用新帳戶授權並測試連接器，確保使用者不會看到「未驗證的應用程式畫面」。
  8. 請務必遵循 Looker Studio Gallery 服務條款 (提交者)。

符合所有規定後，請點選下方按鈕，為連接器申請審查：

發布合作夥伴連接器