> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 市集整合 - Google

> 在 Game Manager 中使用 Google Cloud 服務帳戶和 Google Play Android Developer API，將 Google Play 應用程式連結至您的 PlayFab 遊戲。

# 市集整合：Google

本教學課程說明如何將 Google Play 應用程式成功整合至 Game Manager 中的遊戲。

## 必要條件

1. Google 帳戶。
2. 已建立並可在 [Google Play](https://play.google.com/console/developers) 中使用的應用程式。
   1. 請確定您的應用程式已啟用 [Google Play Android Developer API](https://console.cloud.google.com/apis/library/androidpublisher.googleapis.com)。
3. [Google Cloud](https://cloud.google.com/) 的存取權。
4. 現有的 Google Cloud 專案。

## 步驟 1：建立服務帳戶

您需要完成的第一個步驟是建立服務帳戶。這是透過 [Google Cloud Platform](https://cloud.google.com/) (GCP) 完成。

1. 從頂端導覽列，選取左上角的功能表按鈕。

2. 選取 **IAM & Admin**，然後選取 **Service Accounts**。

3. 從頁面頂端，選取 **Create Service Account**。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/create-service-account.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=bab57343b82b35377ed80d9c8832a22c" alt="建立服務帳戶按鈕" width="409" height="47" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/create-service-account.png" />

4. 填寫服務帳戶詳細資料，然後選取 **Create and Continue**。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/service-account-details.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=1f3757460206c4dd7290090694aa5851" alt="服務帳戶詳細資料" width="563" height="530" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/service-account-details.png" />

5. 在 **Select a role** 下拉式選項中尋找 **Service Account User**，以授與新服務帳戶存取權。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/service-account-role.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=cadc24a9dfb48ad6562db597e41aed69" alt="服務帳戶專案存取權" width="428" height="152" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/service-account-role.png" />

6. 按下 **Done** (您可以略過 **Grant users access to this service account** 步驟)。

建立服務帳戶後，系統會將您導回 **Service Accounts** 頁面，其中會顯示指定專案下所有服務帳戶的清單。

### 將權限新增至現有的服務帳戶

此子步驟旨在說明如何將專案權限新增至現有的服務帳戶，或在建立帳戶時遺漏新增權限的情況下使用。

1. 從左上方的導覽列功能表，前往 GCP 中的 **IAM & Admin** 區段。

2. 從服務帳戶清單的開頭選取 **Grant Access**。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/grant-service-account-access.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=1bacaf530db1c49b3f02d127a5aed3c5" alt="授與服務帳戶存取權" width="336" height="94" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/grant-service-account-access.png" />

3. 在 **New principals** 方塊中選取所需的服務帳戶。它會在專案中所有現有的服務帳戶中搜尋您的服務帳戶名稱，並提示您選取對應至所需服務帳戶的特定選項。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/search-service-account.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=a72c5307217cce842a6cc95cb4abe995" alt="搜尋您的服務帳戶" width="589" height="452" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/search-service-account.png" />

4. 在 **Select a role** 下拉式清單中搜尋 **Service Account User** 角色並指派。

5. 按下 **Save**。

## 步驟 2：取得帳戶認證

建立並備妥**服務帳戶**後，下一步是取得包含**私密金鑰** (認證) 的 JSON 檔案，該金鑰將新增至 **Game Manager** 中的**遊戲**。若要執行此動作，請依照下列步驟進行：

1. 從 [GCP](https://cloud.google.com/) 開啟左側導覽列功能表，然後在 **IAM & Admin** 底下選擇 **Service Accounts**。

2. 這會載入目前專案下所有服務帳戶的清單。尋找您要取得認證的帳戶並選取它。(在此案例中，我們的服務帳戶名為 **Integration Test**，因此會顯示為 "integration-test\@.....")。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/service-account-name.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=ca3a79c303d453281d71704a3437e4ef" alt="服務帳戶名稱" width="615" height="67" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/service-account-name.png" />

3. 畫面會顯示您的服務帳戶詳細資料，畫面上方有多個索引標籤，請選取 **Keys** 索引標籤。

4. 選取 **Add Key** > **Create new key**。

5. 選取 **JSON** 作為 **Key type**，然後按下 **Create**。

6. 這會將 .json 檔案下載到您的電腦。開啟該檔案，並確定其中包含**私密金鑰**。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/private-key-file-contents.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=7d1ab86dc92be96d3ee459c6f77b7650" alt="私密金鑰檔案內容" width="1210" height="614" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/private-key-file-contents.png" />

<Note>
  請確定您以適當且安全的方式儲存該 JSON 檔案以保護您的資料，稍後在本教學課程中將需要使用它。
</Note>

## 步驟 3：連結至 Google Play Console

接下來前往 [Google Play Console](https://play.google.com/console/developers)，將新建立的認證與您的遊戲連結。

<Note>
  此步驟假設您已完成必要條件，在 Google Play Console 中已建立並備妥應用程式。如果您還沒有應用程式，現在就是建立的時候。
</Note>

1. 開啟 [Google Play Console](https://play.google.com/console/developers)。

2. 從左側導覽功能表，選取 **Users and permissions**。

3. 在畫面右側，選取 **Invite new users**。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/invite-new-users.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=9f71a2eecb7d5c6729b2ad9cce2bdedf" alt="邀請新使用者按鈕" width="439" height="70" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/invite-new-users.png" />

4. 在電子郵件地址欄位中，新增 GCP 中服務帳戶的電子郵件地址。它看起來應該類似這樣：`integration-test@iapandroid-151919.iam.gserviceaccount.com`。

5. 您會在 **Permissions** 區段中看到幾個索引標籤，預設應會選取 **App permissions**。選取 **Add app** 選項。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/add-app-permissions.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=8aa2c8528ba5bc1786d70b97c2162991" alt="新增應用程式權限" width="934" height="411" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/add-app-permissions.png" />

6. 從應用程式清單中，選擇您要連結帳戶的應用程式。在此案例中，它是 **Economy V2 PlayFab Test App**。選取後，按下 **Apply**。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/app-selection.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=d0b7210911021930a9f30a8c4d54a83a" alt="應用程式選取" width="387" height="398" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/app-selection.png" />

7. 會彈出一個視窗，要求您指定要在應用程式中授與該帳戶的權限類型。在 **Financial data** 底下選擇 **Manage orders and subscriptions** 和 **View financial data**，然後按下 **Apply**。

8. 系統會再次將您重新導向至 **Invite user** 畫面 (您在此新增帳戶的電子郵件地址並設定應用程式權限)。但這次，您應按下畫面右下角的 **Invite user**。然後按下 **Send invite** 確認訊息。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/send-invite.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=d87059f9b78b0737add0750f5b91af80" alt="傳送邀請" width="426" height="212" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/send-invite.png" />

傳送邀請後，您就可以在 **Users and permissions** 畫面的 **Users** 清單下看到您的服務帳戶。

## 步驟 4：透過 Game Manager 連結至 PlayFab

現在您的服務帳戶已在 **Google Cloud Platform** 中建立，並成功連結至 **Google Play Console** 中的應用程式。接下來要將其連結至 PlayFab **Game Manager** 中的工作室和遊戲。

1. 開啟 [Game Manager](https://developer.playfab.com/) 並選取您的**遊戲**。

2. 進入遊戲畫面後，從左側導覽功能表選取 **Add-ons** 選項。

3. 搜尋並選取 **Google** 選項。

4. 在畫面右側，選取 **Install Google**，這會顯示完成整合前必須填入的一組資訊。

5. 在 **Google App package ID** 中，您應使用 **Google Play Console** 中的 ID，在我們的案例中是：`com.playfab.economy`，此範例的其餘欄位皆為選用。唯一的其他必要欄位是 **Service Account Key** 欄位，您應在其中貼上從 **Google Cloud Platform** 取得的 JSON 檔案內容。

   <img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/google-completed-fields.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=106e8ba280508dade09237120162da0e" alt="已完成的 Google 附加元件欄位" width="500" height="830" data-path="images/playfab/economy-monetization/economy-v2/marketplace-integrations/google/google-completed-fields.png" />

6. 按下 **Install Google**。這會驗證您在上一個步驟中輸入的資料，您會發現服務帳戶金鑰已簡化，只會顯示 **Private Key Id**。

## 後續步驟

* [設定可從 Google Play 商店購買的 PlayFab 組合包](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/google)


## Related topics

- [市集整合 - 概觀](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview.md)
- [市集整合 - Steam](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/steam.md)
- [市集整合 - Microsoft Store](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/microsoft.md)
- [市集整合 - Apple](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/apple.md)
- [詐騙防範快速入門](/zh-TW/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)