Recall API 可讓遊戲搭配 Play 遊戲服務 (PGS) 使用 現有登入機制 (例如 Google 登入功能)，而且提供流暢的同步處理體驗 玩家的使用者跨裝置的登入資訊，降低新手上路的使用者流失率 並提高第 1 天的留存率 這個 API 會管理使用者的 Play 遊戲服務 (PGS) 帳戶和 透過 Google 伺服器儲存喚回符記，藉此管理遊戲內帳戶。請參考 範例情境：使用 Recall API：
使用者在玩遊戲時，開發人員會透過身分識別系統追蹤使用者進度，同時使用 PGS 與其他驗證方法將使用者登入遊戲。在此範例中，使用者已登入 PGS 帳戶「Laura」，並透過開發人員的身分識別系統建立名為「Racer94」的遊戲內帳戶。當使用者玩遊戲時，開發人員的遊戲伺服器會同步處理遊戲進度。
此外，開發人員會透過 Google 儲存喚回符記，該符記會對應至使用者的遊戲內帳戶。Google 會根據使用者的 PGS 設定檔自動儲存喚回符記。
使用者現在決定在 Google Play 遊戲電腦版上玩遊戲 第一款電腦 讓應用程式從可以最快做出回應的位置 回應使用者要求使用者會自動登入 PGS 帳戶，且 遊戲用戶端檢查該 PGS 是否已建立進度 內容。接著，遊戲伺服器向 Google 查詢 使用這個 PGS 帳戶。如果有，Google 會傳回喚回符記 遊戲伺服器會使用該權杖尋找與使用者相關聯的帳戶 Racer94 來還原他們的進度。使用 PGS 登入 順暢的使用體驗，應用程式還原使用者的進度，但沒有 要求使用者輸入使用者名稱或密碼。此外 可透過現有的身分識別系統使用 PGS 登入功能，並靠 Google 儲存玩家進度與 PGS 帳戶之間的連結。
如上例所示，有兩個主要動作 Recall API：
- 使用者在任一遊戲內登入後，透過 Google 儲存權杖 帳戶。
- 擷取使用者的權杖，以便在遊戲中還原 帳戶。
除了喚回符記，Recall API 也會要求一個穩定的 ID 名為「人物角色」，以強制執行 基數限制條件。你可能會想到 做為標籤，代表使用者在開發人員的遊戲內帳戶 身分識別系統和喚回符記，用來還原 根據玩家在遊戲中的帳戶參與測試請勿重複使用人物角色和符記值 同時在不同國家/地區 PGS 專案。 此外，雖然喚回符記可能會隨著時間變更，但人物角色應保持穩定 以使用者的遊戲內帳戶為準
基數規則
Recall API 會強制執行 PGS 設定檔與遊戲內帳戶之間的 1:1 關係 (稱為「基數規則」)；也就是說，一個人物角色只能連結至一個 PGS 設定檔，而一個 PGS 設定檔也只能連結至一個人物角色。人物角色會做為遊戲內帳戶的穩定 ID，因為喚回符記可能會隨時間變動。
連結至 PGS 設定檔的人物角色也可能會隨時間變動 (因為不同的遊戲內帳戶都會連結至該 PGS 設定檔)。
儲存及擷取喚回符記的詳細技術流程
本節會說明遊戲用戶端、遊戲伺服器、 儲存及擷取喚回符記：
步驟 1：登入 PGS 使用者並擷取工作階段 ID
遊戲會初始化 PGS SDK，並嘗試透過 PGS 登入使用者。
假設使用者已登入，請在遊戲用戶端上要求 Play 遊戲 SDK 的工作階段 ID，並向 Google 的 OAuth 後端要求 OAuth 2.0 符記。工作階段 ID 和 OAuth 2.0 符記可用來與 Google 遊戲後端連線。
步驟 2：擷取任何可用的喚回符記
要求與 PGS 使用者帳戶相關聯的任何喚回符記。如有符記的話，請前往步驟 3a 並還原進度。否則，如果是新使用者且沒有任何符記，則請前往步驟 3b 並儲存新符記。
步驟 3a：如有符記，請還原進度
如有符記的話，請擷取符記並加以解密，然後還原使用者資料。
步驟 3b：如沒有符記，請儲存符記
由於沒有符記，因此系統不會還原任何進度。使用者繼續登入 使用開發人員身分識別系統註冊；如果沒有帳戶，請建立新帳戶 個值。
建立加密的喚回符記，該符記會將使用者的遊戲內帳戶編碼，並連同工作階段 ID 和 OAuth 2.0 符記傳送給 Google。這時 Google 就會將已傳送的喚回符記與玩家 PGS 帳戶建立關聯。
沒有 Play 遊戲服務設定檔的使用者流程
您可以為尚未建立 Play 遊戲服務設定檔的使用者儲存喚回符記，步驟如下： 以使用不分析模式不過，請留意以下兩個重點：
- 如果使用者沒有 Play 遊戲服務設定檔，您就無法擷取權杖。「個人檔案」 建立作業會在使用者嘗試登入遊戲時自動顯示提示訊息 。
- 您必須遵守其他規範
務必透過適當的通知充分說明下列項目，並
取得適當的使用者同意聲明：
- 您將與 Google 分享資料，以便啟用 Play 遊戲帳戶 連結功能。
- 是否能夠管理這項共用設定，例如 Play 遊戲 可以管理叢集設定，像是節點 資源調度、安全性和其他預先設定項目
- 依據《Google 隱私權政策》處理這類資料 政策。
儲存符記和人物角色組合
- 沒有 Play 遊戲服務設定檔的使用者開啟了無設定檔召回遊戲
- Games SDK 會觸發自動登入程序，因為使用者 沒有 Play 遊戲服務設定檔。
- Games SDK 會顯示 Snackbar，告知使用者遊戲已 與 Google 整合您可以啟用這個 Snackbar，使用者可以停用 直到建立個人資料為止
- 遊戲要求喚回存取權。請注意，Play 遊戲服務拒絕了召回存取權要求 裝置中沒有 PGS 設定檔或沒有 Google 裝置上的帳戶。在這種情況下，遊戲在不使用 PGS。
- 使用者透過遊戲內帳戶登入後，遊戲就會建立符記， 玩家角色配對中對應至遊戲內帳戶。遊戲 會將這個配對儲存在 Google 上如果遊戲產生了更多代幣， 使用者登入其他遊戲內帳戶。
在新裝置上啟動遊戲
- 沒有 Play 遊戲服務設定檔的使用者開啟了已啟用無設定檔召回功能的遊戲 應用程式。
- 遊戲會記錄無分析的喚回符記，如「儲存符記」一文所述 和人物角色配對
- 使用者在使用相同帳戶的其他裝置上開啟同一遊戲 設定。
- Games SDK 會觸發設定檔建立作業。使用者可以審查和拒絕 先前儲存的喚回符記此時使用者已經建立 PGS 設定檔。
- PGS 自動登入成功，遊戲也收到 經過驗證的狀態
- 遊戲會照常擷取使用者的喚回符記。
後續步驟
若要將 Recall API 與您的用戶端和遊戲伺服器整合，請遵循 這份導入指南。