- HTTP リクエスト
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- 州名
- 試してみる
指定されたリコール セッション ID にエンコードされた PGS プレーヤー プリンシパルをゲーム内アカウントに関連付けます。
HTTP リクエスト
POST https://games.googleapis.com/games/v1/recall:linkPersona
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
フィールド | |
---|---|
sessionId |
必須。サーバーで生成された、PGS プレーヤー、Google ユーザー、アプリケーションを識別するために必要なすべての情報をエンコードした、不透明な文字列。 |
persona |
必須。ゲーム内アカウントの固定 ID。同じペルソナを別のゲームに再利用しないでください。 |
token |
必須。作成するトークンの値。Play Games に対しては不透明で、不安定(鍵のローテーションで暗号化)であると想定されます。 |
cardinalityConstraint |
必須。ゲーム範囲内のプレーヤーにペルソナをリンクする際に監視するカーディナリティ制約。 |
conflictingLinksResolutionPolicy |
必須。ペルソナをプレーヤーにリンクした結果、指定されたカーディナリティ制約に違反する可能性がある場合に適用する解決ポリシー。 |
共用体フィールド expiration 。オプションのトークンの有効期限または有効期間。expiration は次のいずれかになります。 |
|
expireTime |
入力のみの有効期限(省略可)。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
ttl |
入力のみの(省略可)有効期間(TTL)
|
レスポンスの本文
ペルソナのリンク試行の結果。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{
"state": enum ( |
フィールド | |
---|---|
state |
出力専用。ペルソナのリンク試行の状態。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/androidpublisher
詳しくは、OAuth 2.0 の概要をご覧ください。
RecallTokensCardinalityConstraint
ゲーム範囲内のプレーヤーにペルソナをリンクする際に監視するカーディナリティ制約。
列挙型 | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
ゲーム内ペルソナと Play Games サービス プレーヤーの間の 1 対 1 のカーディナリティ。 リンク処理の終了時点で、プレーヤーとペルソナはアプリケーションの範囲内に収める必要があります。 この制約の指定時に新しいリンクが作成されるかどうかは、選択した
|
ConflictingLinksResolutionPolicy
ペルソナをプレーヤーにリンクした結果、指定されたカーディナリティ制約に違反する可能性がある場合に適用する解決ポリシー。
列挙型 | |
---|---|
KEEP_EXISTING_LINKS |
プレーヤーとペルソナ間のリンクがすでに存在し、新しいリンクが作成されると指定された たとえば、Persona1-Player1 がすでに application1 スコープ内でリンクされており、Persona1-Player2 が application1 スコープ内で新しいリンクを作成しようとした場合、古いリンクは残り、新しいリンクは追加されません。 なお、既存のリンクが指定のポリシーに違反している場合(すべての |
CREATE_NEW_LINK |
プレーヤーとペルソナの間に既存のリンクがすでに存在し、新しいリンクが作成されると指定された たとえば、Persona1-Player1 がすでに application1 スコープ内でリンクされており、Persona1-Player2 が application1 スコープ内で新しいリンクを作成しようとすると、古いリンクが削除され、新しいリンクが追加されて置き換えられます。 |
州
ペルソナのリンク試行の状態。
列挙型 | |
---|---|
LINK_CREATED |
リクエストで指定されたリンクは作成されました。 |
PERSONA_OR_PLAYER_ALREADY_LINKED |
リクエストで指定されたリンクは作成されませんでした。すでに既存のリンクが作成されると、新しいリンクが作成されると指定された RecallTokensCardinalityConstraint に違反するためです。 |