如果應用程式會要求外部使用者提供 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 準備就緒後盡早提交。
應用程式驗證規定
如要在驗證中心將應用程式送交驗證,請調整 Google Auth Platform 設定,並備妥必要的驗證資料。
品牌宣傳和隱私權政策
在 Google Cloud 控制台的「Branding」(品牌宣傳) 頁面中,先確認下列詳細資料再提交:
應用程式首頁:首頁必須可公開存取,並包含應用程式隱私權政策的連結。
隱私權政策連結:在「品牌宣傳」頁面設定的隱私權政策網址,必須與應用程式首頁連結的隱私權政策網址相符。
驗證範圍
在「資料存取權」頁面中,只要求應用程式所需的範圍。Data Manager API 使用機密範圍:
https://www.googleapis.com/auth/datamanager(主要範圍)https://www.googleapis.com/auth/datamanager.partnerlink(合作夥伴連結)
提交驗證申請時,請詳細說明應用程式為何需要存取要求的範圍。
聯絡資訊
Google OAuth 驗證團隊會將所有通訊內容傳送給 Google Cloud 雲端專案中設定的專案擁有者和專案編輯者。請在 Google Cloud 控制台中更新這些聯絡資料,以免錯過資訊要求。
如果驗證團隊提出後續問題或要求更新 (例如變更示範影片或同意畫面設定),審查作業會暫停,直到您回覆為止。如果提交內容已待處理超過幾週,且未收到任何更新,請檢查所有專案擁有者和專案編輯者的電子郵件收件匣 (包括垃圾郵件資料夾)。
示範影片
請提供公開示範影片的連結 (例如不公開的 YouTube 影片或公開的 Google 雲端硬碟連結),說明應用程式如何使用要求的範圍。
請確認影片符合應用程式功能示範影片的所有規定,包括下列 Data Manager API 檢查項目:
完整使用者歷程和 OAuth 授權:在應用程式中顯示完整的使用者歷程,從使用者啟動登入或授權,到完成 OAuth 授權流程。
應用程式身分相符:請確認影片中顯示的應用程式名稱、標誌和品牌宣傳,與 Google Cloud 控制台中的品牌宣傳頁面設定相符。
完整的英文版 OAuth 同意畫面:顯示整個 OAuth 同意畫面,左下角的語言選取器設為「English」,並確認畫面顯示應用程式要求的 Data Manager API 範圍。
應用程式 UI 中的範圍使用情形:示範使用要求範圍的應用程式功能 (例如在應用程式 UI 中建立合作夥伴連結、建立目標對象名單,或設定資料擷取)。
階段 3:準備推出 (已驗證)
Google OAuth 驗證團隊通知您,應用程式驗證要求已獲核准後,您就不必採取任何行動。應用程式現已通過驗證,外部使用者可以授權,不會看到「未經驗證的應用程式」警告畫面。