Google Client ID 設定說明

更新時間：2026-05-14 15:25:32

最後更新時間：2026-05-14

功能說明

Google Client ID 用於識別發起 Google 授權登入的應用程式使用自訂網域的客戶，可設定自有 Google Client ID，使 Google 授權登入與目前自訂網域相符；未設定自有 Client ID 時，系統繼續使用平台預設設定，原有 Google 登入方式不受影響。

設定前需準備以下資訊：

準備項目	說明
Google 帳號	用於登入 Google Cloud Console 並建立 OAuth 應用程式
自訂網域	觀眾存取觀看頁時使用的網域，建議使用 `https`
應用程式品牌資訊	包括應用程式名稱、支援信箱、首頁連結、隱私權政策連結等
授權回呼位址	在 Google Cloud Console 中填寫若不確定完整位址，請聯絡技術支援確認

前往 Google Cloud Console，選擇既有專案，或新建一個專案

在 Google Cloud Console 中進入 Google Auth Platform 的品牌設定頁面，依頁面要求填寫應用程式名稱、支援信箱、授權網域、首頁連結和隱私權政策連結等資訊；這些資訊會影響觀眾在 Google 授權同意畫面上看到的應用程式名稱和品牌展示。

進入憑證或 Clients 頁面，建立新的 OAuth Client

設定項目建議依以下方式填寫：

設定項目	填寫說明
Application type	依業務選擇
Name	填寫便於識別的名稱，例如公司名或業務名
Authorized JavaScript origins	填寫自訂網域的來源位址，例如 `https://www.example.com`該項目只填寫協定、網域和連接埠，不填寫路徑
Authorized redirect URIs	填寫自訂網域對應的完整授權回呼位址該項目可以包含路徑，需與實際登入回呼位址保持一致，例如https://www.example.com/v3/common/callback/google/user/redirect

儲存後，Google Cloud Console 會產生 OAuth 2.0 Client ID

在 OAuth Client 詳細資料中複製產生的 Client ID後續需將該值填寫到保利威直播後台的 Google 授權設定中

儲存時系統會驗證 Client ID 是否有效驗證通過後，設定立即生效

Google 授權設定支援以下狀態：

狀態	說明
目前使用平台預設設定	尚未設定自有 Client ID，系統繼續使用平台預設設定
已設定自有 Client ID	已儲存客戶自有 Client ID，觀看頁 Google 登入會使用該設定

已設定後，系統會脫敏顯示目前 Client ID，並支援修改或恢復預設設定

已設定自有 Client ID 後，可在設定彈窗中執行以下操作：

更換或恢復預設 Client ID 前，系統會進行二次確認

更換 Client ID 後，已透過 Google 登入的觀眾再次登入時不會被視為新用戶，歷史資料互通

設定完成後，可依以下方式檢查：

若仍然授權失敗，優先檢查 Google Cloud Console 中填寫的網域和回呼位址是否與實際存取位址一致

會更換 Client ID 後，已透過舊 Client ID 登入的觀眾再次登入時會被視為新用戶，歷史資料不互通

請檢查以下資訊：