Method: recall.linkPersona

• HTTP-Anfrage
• Anfragetext
  • JSON-Darstellung
• Antworttext
  • JSON-Darstellung
• Autorisierungsbereiche
• RecallTokensCardinalityConstraint
• ConflictingLinksResolutionPolicy
• Bundesland
• Testen!

Verknüpfe das PGS-Spielerhauptkonto, das in der angegebenen Recall-Sitzungs-ID codiert ist, einem In-Game-Konto

HTTP-Anfrage

POST https://games.googleapis.com/games/v1/recall:linkPersona

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum (RecallTokensCardinalityConstraint), "conflictingLinksResolutionPolicy": enum (ConflictingLinksResolutionPolicy), // Union field expiration can be only one of the following: "expireTime": string, "ttl": string // End of list of possible types for union field expiration. }

Felder
sessionId	string Erforderlich. Intransparenter, vom Server generierter String, der alle erforderlichen Informationen zur Identifizierung des Play-Spieldienste-Players, des Google-Nutzers und der Anwendung codiert.
persona	string Erforderlich. Stabile ID des In-Game-Kontos Bitte verwenden Sie nicht dieselbe Persona für verschiedene Spiele.
token	string Erforderlich. Wert des zu erstellenden Tokens. Für Play Spiele nicht transparent. Es wird angenommen, dass es nicht stabil ist (verschlüsselt mit Schlüsselrotation).
cardinalityConstraint	enum (RecallTokensCardinalityConstraint) Erforderlich. Kardinalitätsbeschränkung, die beim Verknüpfen einer Persona mit einem Spieler im Rahmen eines Spiels zu beobachten ist.
conflictingLinksResolutionPolicy	enum (ConflictingLinksResolutionPolicy) Erforderlich. Lösungsrichtlinie, die angewendet wird, wenn die Verknüpfung einer Persona mit einem Player zu einem Verstoß gegen die angegebene Kardinalitätsbeschränkung führen würde.
Union-Feld expiration. Optionale Ablaufzeit oder Gültigkeitsdauer des Tokens. Für expiration ist nur einer der folgenden Werte zulässig:
expireTime	string (Timestamp format) Nur Eingabe. Optionale Ablaufzeit. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
ttl	string (Duration format) Nur Eingabe. Optionale Gültigkeitsdauer. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „s“ endet. Beispiel: "3.5s".

Antworttext

Ergebnis eines Versuchs, die Persona zu verknüpfen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{ "state": enum (State) }

Felder
state	enum (State) Nur Ausgabe Status des Verknüpfungsversuchs der Persona.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

• https://www.googleapis.com/auth/androidpublisher

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

RecallTokensCardinalityConstraint

Kardinalitätsbeschränkung, die beim Verknüpfen einer Persona mit einem Spieler im Rahmen eines Spiels zu beobachten ist.

Enums

ONE_PERSONA_TO_ONE_PLAYER

1:1-Kardinalität zwischen In-Game-Personas und Spielern der Play-Spieldienste Am Ende der Verknüpfung sollte nur ein Eintrag für den Player und die Persona im Anwendungsbereich der Anwendung bleiben. Ob eine neue Verknüpfung erstellt wird oder nicht, wenn diese Einschränkung angegeben wird, wird durch die ausgewählte ConflictingLinksResolutionPolicy bestimmt: Wenn KEEP_EXISTING_LINKS angegeben ist und die angegebene Persona bereits mit einem anderen Spieler verknüpft ist oder der Spieler bereits mit einer anderen Persona verknüpft ist, wird kein neuer Link erstellt. Die bereits vorhandenen Links bleiben unverändert. Wenn CREATE_NEW_LINK angegeben ist und die angegebene Persona bereits mit einem anderen Spieler verknüpft ist oder der Spieler bereits mit einer anderen Persona verknüpft ist, werden die älteren Links entfernt und die neue Verknüpfung erstellt.

ConflictingLinksResolutionPolicy

Lösungsrichtlinie, die angewendet wird, wenn die Verknüpfung einer Persona mit einem Player zu einem Verstoß gegen die angegebene Kardinalitätsbeschränkung führen würde.

Enums
KEEP_EXISTING_LINKS	Wenn bereits Verknüpfungen zwischen einem Spieler und einer Persona vorhanden sind, die zu einem Verstoß gegen die angegebenen RecallTokensCardinalityConstraint führen würden, wenn der neue Link erstellt wird, behalte die bereits vorhandenen Links bei. Wenn zum Beispiel Persona1-Spieler1 bereits im Geltungsbereich von Anwendung1 verknüpft ist und versucht wird, ein neuer Link Persona1-Spieler2 im Bereich von Anwendung1 mit der Einschränkung MANY_PERSONAS_TO_ONE_PLAYER zu erstellen, bleibt der alte Link erhalten und es wird kein neuer Link hinzugefügt. Wenn bereits vorhandene Links gegen die angegebene Richtlinie verstoßen (was passieren kann, wenn nicht alle recall.linkPersona-Aufrufe dieselbe RecallTokensCardinalityConstraint verwenden), werden diese Verstöße durch diese Richtlinie nicht behoben. Zur Behebung von Konflikten muss die Richtlinie {@link CREATE_NEW_LINK verwendet werden, um Links neu zu schreiben, die Konflikte beseitigen.
CREATE_NEW_LINK	Wenn bereits eine Verknüpfung zwischen einem Spieler und einer Persona vorhanden ist, was zu einem Verstoß gegen die angegebenen RecallTokensCardinalityConstraint führen würde, wenn der neue Link erstellt wird, ersetze die bereits vorhandenen Links durch den neuen Link. Wenn zum Beispiel Persona1-Spieler1 bereits im Geltungsbereich von Anwendung1 verknüpft ist und versucht wird, ein neuer Link Persona1-Spieler2 im Bereich von Anwendung1 mit der Einschränkung MANY_PERSONAS_TO_ONE_PLAYER zu erstellen, wird der alte Link entfernt und der neue Link wird hinzugefügt, um ihn zu ersetzen.

Status

Status des Verknüpfungsversuchs der Persona.

Enums
LINK_CREATED	Die in der Anfrage angegebene Verknüpfung wurde erstellt.
PERSONA_OR_PLAYER_ALREADY_LINKED	Der in der Anfrage angegebene Link wurde nicht erstellt, da bereits vorhandene Verknüpfungen dazu führen würden, dass die neue Verknüpfung gegen die angegebenen RecallTokensCardinalityConstraint verstößt.