提交品牌驗證要求

所有存取 Google API 的應用程式都必須驗證,確保其身分和意圖符合《Google API 服務:使用者資料政策》規定。為保護您和 Google 與應用程式的共用使用者,您的同意畫面和應用程式可能需要經過 Google 驗證。

如果應用程式符合下列所有條件,就必須經過驗證:

  • 在 Google API 控制台中,應用程式的使用者類型設為「外部」,發布狀態設為「已發布」。這表示應用程式已正式上線,擁有 Google 帳戶的使用者都能存取。
  • 您希望應用程式在 OAuth 同意畫面顯示標誌或顯示名稱。

驗證應用程式的品牌資訊,可提高使用者認出品牌並決定授予應用程式存取權的可能性。此外,當使用者或 Google Workspace 管理員審查有權存取帳戶的第三方應用程式和服務時,驗證過的品牌資訊也較不容易遭到撤銷。點選「Verify Branding」(驗證品牌宣傳) 按鈕後,自動品牌驗證程序通常會在幾分鐘內完成。在某些情況下,如果無法自動判斷結果,應用程式可能會進入人工審查程序,通常需要 2 到 3 個工作天。

如果應用程式的品牌資訊未經驗證,使用者可能會對您要求存取資料的行為產生疑慮,導致授權人數減少,日後撤銷授權的人數增加。


同意畫面會告知使用者,是誰要求存取他們的資料,以及應用程式需要代表他們存取哪些資料,如圖 1 的方塊 2 所示。

應用程式通過品牌驗證程序並獲得核准後,授予權限的帳戶就更容易清楚瞭解應用程式的身分和使用者資料政策。清楚瞭解這些資訊後,帳戶持有人更有可能授權您的要求,並在 Google 帳戶頁面查看可能撤銷的權限時,保留存取權。您在 Cloud 控制台的 OAuth 品牌資訊頁面設定的內容,會填入下列元件:

  1. 應用程式名稱和標誌 (如圖 1 的方塊 1 所示)
  2. 使用者支援電子郵件地址,會在選取應用程式名稱後顯示 (圖 1 的方塊 2)
  3. 隱私權政策和服務條款的連結 (圖 1 的方塊 3)
編號標籤說明專案品牌資訊通過核准後,OAuth 同意畫面的不同功能。
圖 1. OAuth 同意畫面模擬圖。

授權網域

在品牌驗證程序中,Google 會要求驗證與應用程式 OAuth 同意畫面和憑證相關聯的所有網域。我們要求您驗證可在公開字尾上註冊的網域元件:「頂層私人網域」。舉例來說,如果 OAuth 同意畫面的應用程式首頁設為 https://sub.example.com/product,系統會要求帳戶持有人驗證 example.com 網域的擁有權。

OAuth 同意畫面編輯器的「Authorized domains」(已授權網域) 部分,必須包含「App domain」(應用程式網域) 部分 URI 中使用的頂層私人網域。這些網域包括應用程式首頁、隱私權政策和服務條款。「Authorized domains」(授權網域) 部分也必須包含「網頁應用程式」OAuth 應用程式類型中授權的重新導向 URI 或 JavaScript 來源。

使用 Google Search Console 驗證授權網域的擁有權。擁有網域擁有者權限的 Google 帳戶,必須與使用該授權網域的 API 控制台專案建立關聯。如要進一步瞭解 Google Search Console 中的網域驗證,請參閱「驗證網站擁有權」。


驗證準備步驟

凡是使用 Google API 要求存取資料的應用程式,都必須執行下列步驟,完成品牌驗證:

  1. 確認您的應用程式不屬於「驗證規定的例外狀況」一節中的任何用途。
  2. 請確認應用程式符合相關 API 或產品的品牌規定。舉例來說,請參閱 Google 登入範圍的品牌宣傳指南。
  3. 在 Google Search Console 中,驗證專案授權網域的擁有權。使用與 API 控制台專案相關聯的 Google 帳戶,並具備擁有者或編輯者權限。
  4. 請確認 OAuth 同意畫面上的所有品牌資訊 (例如應用程式名稱、支援電子郵件地址、首頁 URI、隱私權政策 URI 等) 均準確代表應用程式的身分。

應用程式首頁規定

請確認首頁符合下列規定:

  • 首頁必須公開,不能只開放給已登入網站的使用者。
  • 首頁與送審應用程式的關聯性必須明確。
  • Google Play 商店中的應用程式資訊頁面或 Facebook 專頁,不算是有效的應用程式首頁。

應用程式隱私權政策連結規定

請確認應用程式的隱私權政策符合下列規定:

  • 隱私權政策必須向使用者公開,並與應用程式首頁位於相同網域,且連結至 Google API 控制台的 OAuth 同意畫面。請注意,首頁必須包含應用程式功能說明,以及隱私權政策和服務條款 (選用) 的連結。
  • 隱私權政策必須揭露應用程式存取、使用、儲存或分享 Google 使用者資料的方式。使用 Google 使用者資料時,必須遵守已發布之隱私權政策中揭露的做法。

如何將應用程式送交品牌驗證

Google Cloud 控制台專案會整理所有 Cloud 控制台資源。專案包含一組有權執行專案作業的相關聯 Google 帳戶、一組已啟用的 API,以及這些 API 的計費、驗證和監控設定。舉例來說,專案可以包含一或多個 OAuth 用戶端、設定這些用戶端使用的 API,以及設定向使用者顯示的 OAuth 同意畫面,讓使用者授權存取您的應用程式。

如果任何 OAuth 用戶端尚未準備好用於正式環境,建議您從要求驗證的專案中刪除這些用戶端。您可以在「客戶」頁面執行這項操作。

如要提交驗證,請按照下列步驟操作:

  1. 確認應用程式符合《Google API 服務條款》和《Google API 服務使用者資料政策》的規定。
  2. 請在 Cloud 控制台中,隨時更新專案相關帳戶的擁有者和編輯者角色,以及 OAuth 同意畫面的使用者支援電子郵件和開發人員聯絡資訊。這可確保團隊中的正確成員收到任何新要求的通知。
  3. 前往 Cloud 控制台的 OAuth 品牌宣傳頁面。
  4. 按一下「Project selector」(專案選取器) 按鈕。
  5. 在隨即顯示的「Select from」(選取來源) 對話方塊中,選取所需專案。如果找不到專案,但知道專案 ID,可以在瀏覽器中按照下列格式建立網址:

    https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
    

    將 [PROJECT_ID] 替換為要使用的專案 ID。

  6. 在「Branding」(品牌宣傳) 頁面中,提供應用程式的品牌資訊,包括應用程式名稱、標誌、開發人員聯絡資訊和相關連結。您所做的任何變更都會儲存為「品牌宣傳草稿」。

  7. 按一下「驗證品牌宣傳」按鈕,即可開始評估程序。自動審查通常會在幾分鐘內完成。

  8. 評估完成後,請查看狀態。如果成功,狀態會變更為「Ready to publish」(可發布)。如果自動驗證失敗,您可以查看偵測到的問題,並加以修正或申請人工審查。

  9. 按一下「發布品牌宣傳」按鈕,即可發布新的品牌宣傳。

  10. 如果應用程式也需要驗證機密或受限制的範圍,請前往 OAuth 驗證中心追蹤資料存取狀態,並提供要求的任何其他資訊,例如示範影片。請注意,您必須先發布品牌宣傳狀態,才能要求驗證資料存取權。

  11. 使用「Add or remove scopes」按鈕,宣告應用程式要求的所有範圍。系統會在「Non-sensitive scopes」部分預填 Google 登入所需的一組初始範圍。新增的範圍會分類為非機密、機密或受限制。

  12. 針對應用程式中的相關功能,您最多可以提供三個相關說明文件的連結。

  13. 在後續步驟中,提供應用程式所需的任何其他資訊。

發布品牌宣傳資訊或提交資料存取要求後,Google 信任與安全團隊可能會透過電子郵件與您聯絡,要求您提供其他資訊或完成必要步驟。請查看「開發人員聯絡資訊」部分中的電子郵件地址,以及 OAuth 同意畫面中的支援電子郵件地址,確認是否有要求提供更多資訊的通知。您也可以查看專案的「品牌宣傳」或「驗證中心」頁面,確認專案目前的審查狀態,包括審查程序是否因等待您回覆而暫停。

驗證規定的例外狀況

如果您的應用程式將用於下列各節所述的任何情境,則不需提交審查。

個人使用

舉例來說,如果您是應用程式的唯一使用者,或應用程式僅供少數人使用,且您都認識這些人,您和少數使用者可能不介意略過未經驗證的應用程式畫面,並授予個人帳戶應用程式存取權。

用於開發、測試或預備環境層級的專案

為遵守 Google OAuth 2.0 政策,建議您為測試和正式環境建立不同的專案。建議您只有在想讓所有 Google 帳戶使用者都能存取應用程式時,才提交應用程式進行驗證。因此,如果應用程式處於開發、測試或預備階段,就不需要驗證。

如果應用程式處於開發或測試階段,您可以將「Publishing Status」(發布狀態) 保持在預設設定「 Testing」(測試中)。這項設定表示應用程式仍在開發階段,只有測試使用者清單中的人員可以存取。您必須管理參與應用程式開發或測試的 Google 帳戶清單。

警告訊息,指出 Google 尚未驗證正在測試的應用程式。
圖 2. 測試人員警告畫面

僅限服務擁有的資料

如果應用程式使用服務帳戶,且只存取自己的資料,不存取任何使用者資料 (連結至 Google 帳戶),則不需提交驗證。

如要瞭解什麼是服務帳戶,請參閱 Google Cloud 說明文件中的「服務帳戶」。如需使用服務帳戶的操作說明,請參閱「針對伺服器對伺服器應用程式使用 OAuth 2.0」。

內部專用

這表示只有 Google Workspace 或 Cloud Identity 組織中的人員才能使用該應用程式。專案必須由組織擁有,且 OAuth 同意畫面必須設為內部使用者類型。在這種情況下,應用程式可能需要經過組織管理員核准。詳情請參閱「Google Workspace 的其他注意事項」。

全網域安裝

如果您的應用程式只會指定 Google Workspace 或 Cloud Identity 機構的使用者,且一律使用全網域安裝,則不需要進行品牌驗證。不過,如果應用程式使用受限或敏感範圍,則須進行應用程式驗證。這是因為全網域安裝可讓網域管理員授權第三方和內部應用程式存取使用者資料。只有組織管理員帳戶可以將應用程式加入許可清單,以便在網域內使用。

如要瞭解如何將應用程式設為全網域安裝,請參閱常見問題「我的應用程式有來自其他 Google Workspace 網域的公司帳戶使用者」。