コンテンツにスキップ

グループマッチAPI

これは、ゲームプレイ中に知人や友人などのグループでマッチングするために使用されるAPIです。

マッチングリクエストを作成する前に、2人以上のアプリユーザーがグループを作成し、グループの代表者がマッチングリクエストを進める必要があります。

Note

Group APIは、Match Unit / PersonnelのMatch ID設定がTeamに設定されている場合にのみ使用できます。

グループを作成

これは、同じチームにメンバーを招待するためのグループを作成するAPIです。

  • リクエストの作成者がグループリーダー（ルームリーダー）になります。
  • 個人マッチングリクエスト中は使用できません。
  • 知人を招待するためのエントリーコードが作成時に提供されます。
  • 作成時に、match IDのルールに対応するスコア情報を入力できます。

リクエストURL

ライブURL https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group
サンドボックスURL https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group
HTTPメソッド POST
コンテンツタイプ application/json

ヘッダーパラメータ

フィールド名 説明 タイプ 必須
Authorization API呼び出しのための認証トークン（ベアラー） string Y

パスパラメータ

フィールド名 説明 タイプ 必須
gameIndex Hiveコンソールアプリセンターで確認できるプロジェクト識別子 int はい
matchId Hiveコンソールで作成された各マッチの識別子 int はい

リクエストボディ

フィールド名 説明 タイプ 必須
playerId アカウント識別子 long Y
point これはマッチングに使用されるスコアです。入力範囲は0 ~ 999,999,999です。提供されない場合は0として扱われます。 integer N
extraData 追加のアカウント情報（ニックネーム、レベル、国など）。最大256文字を入力できます。マッチング結果に含まれます。 string N

応答

フィールド名 説明 タイプ
groupCode グループに入るために必要なコード string
ownerPlayerId グループオーナー（ホスト）のアカウント識別子 long
memberInfos 結果メッセージ object
matchInfo グループが属するgameIndexとmatchIdに関する情報 object
requstingStatus リクエストステータス情報 string

リクエストサンプル

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/group' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"playerId":1}'

応答サンプル

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfos": [
        {
            "playerId": 1
        }
    ],
    "requestingStatus": "notRequested"
}

グループに参加

これは、アプリユーザーがグループに参加するために、グループリーダー（ルームリーダー）から受け取ったコード（groupCode）を使用してグループに参加する際に使用されるAPIです。

リクエストURL

ライブURL https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/groups/code/{code}/member
サンドボックスURL https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/groups/code/{code}/member
HTTPメソッド POST

ヘッダーパラメータ

フィールド名 説明 タイプ 必須
Authorization API呼び出しのための認証トークン（Bearer） string Y

パスパラメータ

フィールド名 説明 タイプ 必須
gameIndex Hiveコンソールアプリセンターで確認できるプロジェクト識別子 int はい
matchId Hiveコンソールで作成された各マッチの識別子 int はい
code グループ作成APIのレスポンスで受け取ったgroupCodeの値 string はい

リクエストボディ

フィールド名 説明 タイプ 必須
playerId アカウント識別子 long Y
point これはマッチングに使用されるスコアです。入力範囲は0 ~ 999,999,999です。入力しない場合は0として扱われます。 integer N
extraData 追加のアカウント情報（ニックネーム、レベル、国など）。最大256文字まで入力できます。マッチング結果に含まれます。 string N

応答

フィールド名 説明 タイプ
groupCode 対応するグループに入るためのコード string
ownerPlayerId グループリーダー（ホスト）アカウントの識別子 long
memberInfos 結果メッセージ object
matchInfo グループが属するgameIndexとmatchIdに関する情報 object
requestingStatus リクエストステータス情報 string

リクエストサンプル

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/groups/code/0343322/member' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"playerId":2}'

レスポンスサンプル

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        },
        {
            "playerId": 2
        }
    ],
    "requestingStatus": "notRequested"
}

グループを離れる

これは、現在参加しているグループを離れたいときに使用されるAPIです。グループリーダー（ルームリーダー）が離れた場合、残りのメンバーのうちの1人が次のグループリーダーになります。

メンバーが残っていない場合、グループは削除されます。

リクエストURL

ライブURL https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group
サンドボックスURL https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group
HTTPメソッド DELETE

ヘッダーパラメータ

フィールド名 説明 タイプ 必須
認証 API呼び出しのための認証トークン（ベアラー） 文字列 はい

パスパラメータ

フィールド名 説明 タイプ 必須
gameIndex Hiveコンソールアプリセンターで利用可能なプロジェクト識別子 int はい
matchId Hiveコンソールで作成された各マッチの識別子 int はい
playerId ユーザーID long はい

応答

200 OKの場合、ボディは空です。

リクエストサンプル

curl --location --request DELETE 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/players/2/group' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a'

応答サンプル

通常処理された場合、特別な応答コンテンツはありません。

グループ強制排除 (キックアウト)

これは、グループリーダー（ルームリーダー）が特定のメンバーを強制的に追放することを許可するAPIです。

リクエスト URL

ライブURL https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group/members/{targetPlayerId}
サンドボックスURL https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group/members/{targetPlayerId}
HTTPメソッド DELETE

ヘッダー パラメータ

フィールド名 説明 タイプ 必須
認証 API呼び出しのための認証トークン（ベアラー） 文字列 はい

パスパラメータ

フィールド名 説明 タイプ 必須
gameIndex Hiveコンソールアプリセンターで確認できるプロジェクト識別子 int はい
matchId Hiveコンソールで作成された各マッチの識別子 int はい
playerId ユーザーID long はい
targetPlayerId 強制的に削除されるメンバーのID long はい

応答

これはグループ作成APIの結果データの形式です。メンバー情報（memberInfos）から強制的に削除されたメンバーの情報のみが削除されます。

フィールド名 説明 タイプ
groupCode 対応するグループに入るためのコード string
ownerPlayerId グループリーダー（ホスト）の識別子 long
memberInfos 結果メッセージ object
matchInfo グループが属するgameIndexとmatchIdの情報 object
requstingStatus リクエストステータス情報 string

リクエストサンプル

curl --location --request DELETE 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/players/1/group/members/2' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a'

レスポンスサンプル

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        }
    ],
    "requestingStatus": "notRequested"
}

グループ情報取得（グループメンバーに基づく）

これは、アプリユーザーがリクエスト時に所属しているグループに関する情報を取得するAPIです。さまざまな目的で使用でき、定期的にポーリングを通じて確認する必要があります。

通常、以下の目的で使用されます。

  • グループに参加したアプリユーザーのリストを確認する
  • マッチングリクエスト後のマッチング結果を確認する

リクエストURL

ライブURL https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group
サンドボックスURL https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group
HTTPメソッド GET

ヘッダー パラメータ

フィールド名 説明 タイプ 必須
認証 API呼び出し用の認証トークン（ベアラー） 文字列 はい

パスパラメータ

フィールド名 説明 タイプ 必須
gameIndex Hiveコンソールアプリセンターで見つけることができるプロジェクト識別子 int はい
matchId Hiveコンソールで作成された各マッチの識別子 int はい
playerId ユーザーID long はい

応答

フィールド名 説明 タイプ
groupCode 対応するグループに入るためのコード string
ownerPlayerId グループリーダーのアカウントの識別子 long
memberInfos 結果メッセージ object
matchInfo グループのgameIndexとmatchIdに関する情報 object
requstingStatus リクエストステータス情報 string
requestingInfo マッチングリクエスト情報 object
matchingInfo マッチング進行状況情報 object

リクエストサンプル

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/players/1/group' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a'

応答サンプル

// 매칭 요청 전
{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        }
    ],
    "requestingStatus": "notRequested"
}
// 매칭이 성사된 이후 (2:2 팀전)
{
    "groupCode": "3683207",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1,
            "ready": true
        },
        {
            "playerId": 2,
            "ready": true
        }
    ],
    "matchingInfo": {
        "status": "matched",
        "matchingId": "2:1_2024-12-18T06:55:19.91_1",
        "teamInfos": [
            {
                "teamIndex": 0,
                "playerInfos": [
                    {
                        "playerId": 4,
                        "point": 50,
                        "extraData": "bbb"
                    },
                    {
                        "playerId": 3,
                        "extraData": "aaa"
                    }
                ]
            },
            {
                "teamIndex": 1,
                "playerInfos": [
                    {
                        "playerId": 1,
                        "extraData": "extra1"
                    },
                    {
                        "playerId": 2,
                        "point": 250,
                        "extraData": "aaa"
                    }
                ]
            }
        ]
    },
    "requestingStatus": "requested",
    "requestingInfo": {
        "requestTimeUtc": "2024-12-18T06:55:19.17"
    }
}
// 매칭 시간이 초과된 경우(timeout)
{
    "groupCode": "0400606",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1,
            "ready": true
        },
        {
            "playerId": 2,
            "ready": true
        }
    ],
    "matchingInfo": {
        "status": "timeout"
    },
    "requestingStatus": "requested",
    "requestingInfo": {
        "requestTimeUtc": "2024-12-20T06:37:47.99"
    }
}

コードによるグループ情報取得 (by Code)

これは、グループリーダー（ルームリーダー）によって提供されたコード（groupCode）を使用して、グループが存在するかどうかを確認するAPIです。

リクエスト URL

ライブURL https://api-match.withhive.com/gameindexes/{gameIndex}/groups
サンドボックスURL https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/groups
HTTPメソッド GET

ヘッダーパラメータ

フィールド名 説明 タイプ 必須
認証 API呼び出しのための認証トークン（ベアラー） 文字列 はい

パスパラメータ

フィールド名 説明 タイプ 必須
gameIndex Hiveコンソールアプリセンターで確認できるプロジェクト識別子 int Y

クエリパラメータ

フィールド名 説明 タイプ 必須
コード グループコード (groupCode) 文字列 はい

応答

フィールド名 説明 タイプ
groupCode グループに入るために必要なコード 文字列
ownerPlayerId グループのオーナー（ホスト）の識別子 長整数
matchInfo グループが属するgameIndexとmatchIdに関する情報 オブジェクト

リクエストサンプル

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/groups?code=0343322' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a'

レスポンスサンプル

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1
}

メンバー情報の更新

グループに属するメンバーが自分の情報を変更したいときに使用されるAPIです。変更できる情報は以下の通りです。

  • 準備状態 (ready) - グループリーダー（ルームリーダー）は未使用のアイテムです。\n
  • スコア (point)\n
  • 追加情報 (extraData)

リクエストURL

ライブURL https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group/memberinfo
サンドボックスURL https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/players/{playerId}/group/memberinfo
HTTPメソッド PATCH
コンテンツタイプ application/json

ヘッダーパラメータ

フィールド名 説明 タイプ 必須
Authorization API呼び出しのための認証トークン（ベアラー） string Y

パスパラメータ

フィールド名 説明 タイプ 必須
gameIndex Hiveコンソールアプリセンターで確認できるプロジェクト識別子 int Y
matchId Hiveコンソールで作成された各マッチの識別子 int Y
playerId ユーザーID long Y

リクエストボディ

フィールド名 説明 タイプ 必須
ready 準備状態 boolean Y
point これはマッチングに使用されるスコアです。入力範囲は0 ~ 999,999,999です。入力しない場合は0として扱われます。 integer N
extraData 追加のアカウント情報（ニックネーム、レベル、国など）。最大256文字まで入力できます。マッチング結果に含まれます。 string N

応答

フィールド名 説明 型
groupCode 対応するグループに入るためのコード string
ownerPlayerId グループリーダーのアカウント識別子 long
memberInfos 結果メッセージ object
matchInfo グループが属するgameIndexとmatchIdの情報 object
requstingStatus リクエストステータス情報 string

リクエストサンプル

curl --location --request PATCH 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/players/2/group/memberinfo' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"ready":false,"point":0,"extraData":""}'

応答サンプル

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        }
    ],
    "requestingStatus": "notRequested"
}

リクエストの一致

これは、各グループがマッチングを開始するために要求されたAPIです。

  • matchId に対応するマッチを事前にコンソールで作成する必要があります。（個人マッチングリクエストと同様）
  • リクエスト時には、少なくとも2人のメンバーが必要です。
  • グループリーダー（ルームリーダー）でないメンバーは、'準備状況'（Ready）を true に設定する必要があります。
  • 進行中のマッチがある場合は、リクエストを行う前にそれを整理（削除）する必要があります。
  • リクエストを行えるのはグループ代表（ルームリーダー）のみです。

リクエストURL

ライブURL https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group/request
サンドボックスURL https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group/request
HTTPメソッド POST
コンテンツタイプ application/json

ヘッダーパラメータ

フィールド名 説明 タイプ 必須
認証 API呼び出しのための認証トークン（Bearer） 文字列 はい

パスパラメータ

フィールド名 説明 タイプ 必須
gameIndex Hiveコンソールアプリセンターで確認できるプロジェクト識別子 int はい
matchId Hiveコンソールで作成された各マッチの識別子 int はい

リクエストボディ

フィールド名 説明 タイプ 必須
playerId アカウント識別子 long Y

応答

フィールド名 説明 タイプ
groupCode 対応するグループに入るためのコード string
ownerPlayerId グループリーダー（ホスト）の識別子 long
memberInfos 結果メッセージ object
matchInfo グループが属するgameIndexとmatchIdに関する情報 object
requstingStatus リクエストステータス情報 string
requestingInfo マッチングリクエスト情報 object
matchingInfo マッチング進行状況情報 object

リクエストサンプル

curl --location 'http://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/group/request' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"playerId":1}'

レスポンスサンプル

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        },
        {
            "playerId": 2,
            "ready": true
        }
    ],
    "matchingInfo": {
        "status": "matchingInProgress"
    },
    "requestingStatus": "requested",
    "requestingInfo": {
        "requestTimeUtc": "2024-12-05T07:35:35.15"
    }
}

一致するリクエストをキャンセル

リクエストURL

ライブURL https://api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group/request
サンドボックスURL https://sandbox-api-match.withhive.com/gameindexes/{gameIndex}/matchmakings/{matchId}/group/request
HTTPメソッド DELETE

ヘッダー パラメータ

フィールド名 説明 タイプ 必須
認証 API呼び出しのための認証トークン（ベアラー） 文字列 はい

パスパラメータ

フィールド名 説明 タイプ 必須
gameIndex Hiveコンソールアプリセンターで確認できるプロジェクト識別子 int はい
matchId Hiveコンソールで作成された各マッチの識別子 int はい

リクエストボディ

フィールド名 説明 タイプ 必須
playerId アカウント識別子 long Y

応答

フィールド名 説明 タイプ
groupCode グループに入るためのコード 文字列
ownerPlayerId グループリーダーの識別子 長整数
memberInfos 結果メッセージ オブジェクト
matchInfo グループに属するgameIndexとmatchIdの情報 オブジェクト
requstingStatus リクエストステータス情報 文字列

リクエストサンプル

curl --location --request DELETE 'https://sandbox-api-match.withhive.com/gameindexes/2/matchmakings/1/group/request' --header 'Content-Type: application/json' --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNzAyNDU4MTkzLCJqdGkiOiIxMzY2NDk4MjcxIn0.VSwvsTE-tS0sL_e9p9gNvHRkMCbsycSO4ObE4J2ya3a' --data '{"playerId":3}'

応答サンプル

{
    "groupCode": "0343322",
    "matchInfo": {
        "gameIndex": 2,
        "matchId": 1
    },
    "ownerPlayerId": 1,
    "memberInfo": [
        {
            "playerId": 1
        },
        {
            "playerId": 2
        }
    ],
    "requestingStatus": "notRequested"
}

公共の応答

これは、グループに関連するAPIレスポンスで一般的に使用されるフィールドの説明です。

memberInfos

グループに属するメンバーに関する情報（グループリーダーまたはルームリーダーを含む）で構成されるフィールドは以下の通りです。

フィールド名 説明 タイプ
playerId アカウント識別子 long
ready 準備状態 boolean
point グループに参加する際に入力されたスコア（更新時） integer
extraData グループに参加する際に入力された追加情報（更新時） string

matchInfo

グループが属するgameIndexおよびmatchId情報で構成されるフィールドは次のとおりです。

フィールド名 説明 タイプ
gameIndex コンソールのApp Centerに登録されたプロジェクトのゲームインデックス値 整数
matchId コンソールのマッチメイキングに登録されたマッチID 整数

requestingStatus

一致するリクエストステータスフィールドに対応する値は次のとおりです。

  • notRequested: マッチングは要求されていません
  • requested: マッチングが要求されました

requestingInfo

これは一致するリクエスト情報フィールドです。

フィールド名 説明 タイプ
requestTimeUtc UTC+0に基づくリクエスト時間 文字列

matchingInfo

一致する進捗情報で構成されるフィールドは以下の通りです。

フィールド名 説明 タイプ
status マッチング進行状況のステータス 文字列
matchingId マッチされたペアに割り当てられたID。上記のstatusがmatchedのときに追加されます。 文字列
privateInfos （個別マッチの場合）マッチされたアプリユーザーの情報の配列を出力します。 配列
teamInfos （チームマッチの場合）マッチされたアプリユーザーの情報の配列を出力します。 配列

matchingInfo → status

一致する進捗情報のステータスフィールドに対応する値は次のとおりです。

  • matchingInProgress : マッチング中
  • timeout : 制限時間内にマッチがありませんでした
  • matched : マッチ成功

matchingInfo → privateInfos

マッチング進行情報の中で、パーソナルマッチングアプリのユーザー情報を構成するフィールドは以下の通りです。これは、matchingInfo → teamInfos → playerInfosと同じデータ形式です。

フィールド名 説明 タイプ
playerId アカウント識別子。0の場合はボットとして処理する必要があります long
point グループに参加する際に入力されるスコア（更新時） integer
extraData グループに参加する際に入力される追加情報（更新時） string

matchingInfo → teamInfos

チーム情報を構成するフィールドは、マッチング進捗情報のグループマッチングで一致したものは以下の通りです。

フィールド名 説明 タイプ
teamIndex チームを区別するための値、0から始まる 整数
playerInfos チームに属するアプリユーザーに関する情報 配列

matchingInfo → teamInfos → playerInfos

マッチング進行中に一致したチームのアプリユーザー情報を構成するフィールドは以下の通りです。
これは、matchingInfo → privateInfosと同じデータ形式です。

フィールド名 説明 タイプ
playerId アカウント識別子。0の場合はボットとして処理する必要があります long
point グループに参加する際（更新時）に入力されたスコア integer
extraData グループに参加する際（更新時）に入力された追加情報 string