OAuth 應用程式驗證

如果應用程式會要求外部使用者提供 Data Manager API 的使用者憑證,則必須先通過 Google OAuth 應用程式驗證,才能推出。

本指南說明開發期間建議的目標對象設定轉換,以及完成 Google OAuth 應用程式驗證的步驟。

應用程式目標對象階段

視開發階段而定,在 Google Cloud 控制台的「Audience」(目標對象) 頁面中,設定不同的「User type」(使用者類型) 和「Publishing status」(發布狀態) 設定。請按照下列階段操作,順利從初始測試轉換至正式環境。

階段 1:初步開發 (測試)

開始開發及測試基本 API 要求時:

  • 發布狀態:設為「測試」。
  • 使用者類型:

    如果 Google Cloud 雲端專案屬於 Google Workspace 組織,且只有組織內的使用者會使用應用程式,請選取「Internal」(內部)。

    否則請選取「外部」。

  • 測試使用者:如果將「User type」(使用者類型) 設為「External」(外部),請按一下「Add users」(新增使用者),手動新增用於產生憑證的 Google 帳戶。只有列出的 Google 帳戶可以授權應用程式,且須遵守測試限制和權杖到期規則。

  • 驗證:測試期間不需要驗證。如果選取「外部」,測試使用者會先看到警告畫面,確認他們有權測試未經驗證的應用程式,然後才會進入同意畫面。

第 2 階段:接近推出日期 (提交驗證)

整合完成、使用者介面建構完畢,且預計在下個月推出:

  • 發布狀態:轉換為「正式版」。
  • 使用者類型:如果應用程式服務對象是機構外部客戶 (例如廣告主客戶),請設為「外部」。
  • 敬請採取行動:將應用程式送交驗證。Google OAuth 應用程式驗證程序可能需要數週,因此請在 UI 準備就緒後盡早提交。
  • 處理早期測試人員:在驗證審查期間,您的應用程式仍未通過外部使用者驗證。如需招募早期 Beta 版測試人員:
    • 請告知他們會看到「未經驗證的應用程式」畫面。
    • 請他們依序點選「Advanced」(進階) 和 「Go to APP_NAME (unsafe)」(前往「<應用程式名稱>」(不安全)),繼續操作。

應用程式驗證規定

如要在驗證中心將應用程式送交驗證,請調整 Google Auth Platform 設定,並備妥必要的驗證資料。

驗證範圍

在「資料存取權」頁面中,只要求應用程式所需的範圍。Data Manager API 使用機密範圍:

  • https://www.googleapis.com/auth/datamanager (主要範圍)
  • https://www.googleapis.com/auth/datamanager.partnerlink (合作夥伴連結)
聯絡資訊

Google OAuth 驗證團隊會將所有通訊內容傳送給 Google Cloud 雲端專案中設定的專案擁有者和專案編輯者。請在 Google Cloud 控制台中更新這些聯絡資料,以免錯過資訊要求。

示範影片

請提供公開示範影片的連結 (例如不公開的 YouTube 影片或公開的 Google 雲端硬碟連結),說明應用程式如何使用要求的範圍。

請確認影片符合應用程式功能示範影片規定。

階段 3:準備推出 (已驗證)

Google OAuth 驗證團隊通知您,應用程式驗證要求已獲核准後,您就不必採取任何行動。應用程式現已通過驗證,外部使用者可以授權,不會看到「未經驗證的應用程式」警告畫面。