跳轉到主要內容
本教學課程將引導您完成使用 Google 和 HTML5/JavaScript 進行 PlayFab 驗證的程序。

需求

您需要:

伺服器和網域

本指南需要具有有效網域的伺服器。如果您還沒有已註冊的網域和遠端 Web 伺服器,請依照我們的執行 HTTP 伺服器進行測試教學課程,了解如何設定並執行具有有效網域名稱的本機 Web 伺服器。 在本指南中,我們假設您的網域是 [http://playfab.example](http://playfab.example)。

註冊 Google API 專案

首先,瀏覽至 Google API 主控台:
  1. 瀏覽至 CREATE PROJECT 並選取它。
Google API Manager 建立新的認證
  1. 填寫 Project Name 下方的欄位。
  2. 選取 Create 按鈕。
Google API Manager 新專案
API Manager 需要 10 到 20 秒來產生專案,這是正常現象。
建立專案後:
  1. 瀏覽至 OAuth consent screen。
  2. 在 User Type 下選取 External
  3. 然後選取 Create。
Google API Manager OAuth 同意畫面
  1. 填寫應用程式名稱
  2. 確認 user support email 和 Developer Contact Email 都已填入電子郵件
  3. 然後選取 SAVE AND CONTINUE
Google API Manager OAuth 同意畫面設定 Google API Manager OAuth 同意畫面設定 2
  1. 接著,瀏覽至 Credentials。
  2. 選取 Create credentials。
  3. 然後選取 OAuth client ID。
Google API Manager 開啟 OAuth 認證
  1. 選取 Web Application 作為您的 Application type。
  2. 為您的應用程式指定 Name。
  3. 將您的網域新增至 Authorized JavaScript origins:在我們的案例中是 [PlayFab](http://playfab.example.com)。
  4. 最後,選取 Create 按鈕以認可變更。
Google API Manager 建立 OAuth 認證 在下方所示的 OAuth client 畫面上,Google API Manager 會顯示兩項重要資訊:
  1. 用戶端識別碼
  2. 用戶端密碼。
請務必將這些值複製並儲存在容易存取的安全位置,因為本教學課程稍後所示的授權程序會使用這些值。
Google API Manager OAuth 用戶端識別碼和密碼 前往您遊戲的 PlayFab Game Manager 頁面。
  1. 在功能表中瀏覽至 Add-ons。
  2. 找到並開啟 Google Add-on 圖示/連結。
PlayFab Game Manager 附加元件
  1. 填入 Client ID。
  2. 填入 Client secret。
  3. 然後選取 Install Google 按鈕。
PlayFab Game Manager 安裝 Google 附加元件
截至 2017 年 7 月,Google API Manager 有個壞習慣,就是無法正確連結 Allowed JS 來源網域。如果您收到下列錯誤:“idpiframe_initialization_failed”, details: “Not a valid origin for the client: somedomain.com…”,請移除認證並重新建立。不需要刪除整個專案,只要刪除認證即可。

使用存取權杖進行測試

在此範例中,我們將示範如何使用傳統的存取權杖方法來測試 LoginWithGoogleAccount API。請使用下方提供的 HTML 程式碼進行測試。
請務必*將 YOUR_CLIENT_ID 和 YOUR_PLAYFAB_TITLE 取代為您自己的值。
TypeScript 型別定義檔案中的 LoginWithGoogleAccountRequest 物件缺少 AccessToken 參數。如果您搭配 Node SDK 使用 TypeScript,可以建立自訂型別 interface LoginRequest extends PlayFabClientModels.LoginWithGoogleAccountRequest { AccessToken: string; },並在使用 API 時轉換型別 PlayFabClient.LoginWithGoogleAccount( { AccessToken: accessToken, CreateAccount: true, } as LoginRequest, onPlayFabResponse);
使用 (已淘汰的) Google Sign-in Platform 程式庫進行測試
下列範例使用 Google Sign-In 平台程式庫。根據 Google Identity 公開文件網站,適用於 Web 的 Google Sign-In JavaScript 平台程式庫將於 2023 年 3 月 31 日淘汰。此範例今後將無法用於新建立的 Google 用戶端,請參閱前一個程式碼範例,它使用較新的 Google Identity Services 程式庫!
請記得使用您的 Web 伺服器開啟此頁面,並務必使用您在設定 Google 專案時指定的 URL 存取此頁面 (在我們的案例中是 http://playfab.example)。
  1. 頁面開啟後,選取 G Signed In,然後依照一般的 Google 驗證流程進行。
  2. 完成後,指令碼會嘗試在 PlayFab 端進行驗證並輸出結果。
Google 驗證範例
如果您已經有執行中的 Google 驗證工作階段,就不需要選取 G Signed In。一切都會自動進行。
最後修改於 2026年10月6日