- 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 ゲームには不透明で、不安定であるとみなされます(鍵のローテーションで暗号化されます)。 |
cardinalityConstraint |
必須。ペルソナをゲームのスコープ内のプレーヤーにリンクする際に監視するカーディナリティ制約。 |
conflictingLinksResolutionPolicy |
必須。ペルソナをプレーヤーにリンクすると、指定されたカーディナリティ制約に違反する場合に適用される解決ポリシー。 |
共用体フィールド expiration 。トークンの有効期限または有効期間(省略可)。expiration は次のいずれかになります。 |
|
expireTime |
入力のみ。有効期限(省略可)。 RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: |
ttl |
入力のみ。有効期間(省略可)。 「 |
レスポンスの本文
ペルソナのリンクを試みた結果。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"state": enum ( |
フィールド | |
---|---|
state |
出力のみ。ペルソナのリンク試行のステータス。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/androidpublisher
詳細については、OAuth 2.0 の概要をご覧ください。
RecallTokensCardinalityConstraint
ペルソナをゲームのスコープ内のプレーヤーにリンクする際に監視するカーディナリティ制約。
列挙型 | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
ゲーム内ペルソナと Play ゲームサービス プレーヤーの間の 1 対 1 のカーディナリティ。 リンク操作の終了時までに、プレーヤーとペルソナのエントリは 1 つのみで、アプリケーションのスコープ内に残ります。 この制約を指定したときに新しいリンクが作成されるかどうかは、選択した
|
ConflictingLinksResolutionPolicy
ペルソナをプレーヤーにリンクすると、指定されたカーディナリティ制約に違反する場合に適用される解決ポリシー。
列挙型 | |
---|---|
KEEP_EXISTING_LINKS |
プレーヤーとペルソナの間にリンクがすでに存在し、新しいリンクが作成された場合に指定された たとえば、Persona1-Player1 がすでに application1 のスコープにリンクされていて、application1 のスコープに新しいリンク Persona1-Player2 を なお、既存のリンクが指定されたポリシーに違反している場合(すべての |
CREATE_NEW_LINK |
プレーヤーとペルソナの間に既存のリンクがあり、新しいリンクが作成された場合に指定された たとえば、Persona1-Player1 が application1 のスコープ内ですでにリンクされていて、 |
状態
ペルソナのリンク試行のステータス。
列挙型 | |
---|---|
LINK_CREATED |
リクエストで指定されたリンクが作成されました。 |
PERSONA_OR_PLAYER_ALREADY_LINKED |
リクエストで指定されたリンクは作成されませんでした。すでに既存のリンクが作成されると、指定された RecallTokensCardinalityConstraint に違反する新しいリンクが作成されるためです。 |