​

クイックスタート: Postman 向け PlayFab REST API コレクション

Postman 向け PlayFab REST API コレクションを使い始めます。パッケージをインストールし、基本的なタスクのサンプル コードを試すための手順に従ってください。PlayFab はライブ ゲーム向けの完全なバックエンド プラットフォームです。Postman 向け PlayFab REST API コレクションを使用して次のことができます:

• エンティティ トークンを取得する
• タイトル内のエンティティを追加/変更/削除する
• タイトル コンテンツを構成する

API リファレンス ドキュメント | PlayFab Postman Collection GitHub リポジトリ

​

前提条件

• PlayFab 開発者アカウント
• Postman ネイティブ アプリ
• TLS 1.2 以上を実行する OS (Windows での TLS 1.2 のサポート)

​

PlayFab コレクションの追加

• ワークスペースを作成する

  [!div class=“mx-imgBorder”]

  [!div class=“mx-imgBorder”]

• Import を選択 (ウィンドウの左上)

  [!div class=“mx-imgBorder”]

• Link を選択

  [!div class=“mx-imgBorder”]

  [!div class=“mx-imgBorder”]

• 次のリンクを URL テキスト ボックスに貼り付け、Continue および Import を選択します。 https://raw.githubusercontent.com/PlayFab/PostmanCollection/master/playfabV2.json
  • ベータ版 SDK をダウンロードする場合は、Postman Beta GitHub リポジトリ の playfabV2.json ファイルに移動します。
  • View Raw を選択

    [!div class=“mx-imgBorder”]

  • ブラウザーから URL をコピーし、URL テキスト ボックスにリンクを貼り付けて、Continue および Import を選択します。
• Collections タブ (ウィンドウの左上) の下に PlayFab Postman SDK が表示されます。

  [!div class=“mx-imgBorder”]

​

環境変数の追加

• 新しい環境を作成するには、Environments を選択し、Create Environment を選択します。

  [!div class=“mx-imgBorder”]

• 環境に名前を付けます。「[titleId] - Test Environment」をお勧めします。

• 環境に次の 3 つの変数を追加します:

  変数	初期値	現在値
  TitleId	[titleId]	[titleId]
  SecretKey	[secretKey]	[secretKey]
  EntityToken

[!div class=“mx-imgBorder”]

• 完了したら、Save を選択して新しい環境を保存します。
• 環境のドロップダウン (ウィンドウの右上) を選択して、新しい環境に切り替えます。

  [!div class=“mx-imgBorder”]

​

タイトル エンティティ トークンの取得

PlayFab の エンティティ プログラミング モデル と対話する方法の 1 つは、タイトル エンティティ トークンを取得することです。これは、タイトル構成データを変更したい場合や、多数のプレイヤーに調整を加えたい場合に便利です:

• PlayFab Collections フォルダーの下で、Authentication 名前空間を展開し、GetEntityToken を選択します。
• Headers の下で、X-Authorization のチェックを外します。

  [!div class=“mx-imgBorder”]

• Send を選択します。
• 返されたエンティティ トークンを EntityToken 環境変数に設定します。
  • 応答で EntityToken 文字列をハイライトします。
  • 右クリックし、新しい環境の Set: [Environment] を選択します。
  • EntityToken を選択します。

    [!div class=“mx-imgBorder”]

​

Title_Player_Account エンティティ トークンの取得

PlayFab の エンティティ プログラミング モデル と対話するもう 1 つの方法は、Title_Player_Account エンティティ トークンを取得することです。これは、単一のプレイヤーに変更を加えたい場合に便利です:

• PlayFab Collections フォルダーの下で、Client 名前空間を展開し、LoginWithCustomID を選択します。
• Body の下で、CreateAccount の値を false から true に変更します。
• Send を選択します。
• 返されたエンティティ トークンを EntityToken 環境変数に設定します。
  • 応答で EntityToken 文字列をハイライトします。
  • 右クリックし、新しい環境の Set: [Environment] を選択します。
  • EntityToken を選択します。

    [!div class=“mx-imgBorder”]

​

トラブルシューティング

• タイトル ID / シークレット キーの不一致
  • タイトル エンティティ トークンを取得しようとして 401: Unauthorized エラーが発生する場合は、Game Manager にログインしてタイトル ID とシークレット キーが正しいことを確認してください。
• エンティティ トークンの有効期限切れ
  • 以前にエンティティ トークンを取得しており、他の API の呼び出しに失敗している場合、エンティティ トークンの有効期限が切れている可能性があります。別のエンティティ トークンを取得し、EntityToken 環境変数に保存して、前の API を再度呼び出してください。
• エンティティ トークンの種類の誤り
  • エンティティにはさまざまな種類があります (利用可能な組み込みエンティティ タイプ を参照)。API によって許可されるエンティティ タイプが異なります。たとえば、タイトル エンティティ トークンではなく title_player_account エンティティ トークンで GetLanguageList を呼び出そうとしている可能性があります。
• 誤った環境:
  • 環境ドロップダウン (ウィンドウの右上) を確認して、適切な環境を使用していることを確認してください。

​

次のステップ

これで、PlayFab タイトルの設定を開始するために他の API 呼び出しに渡すエンティティ トークンが得られました。