- HTTP-Anfrage
- Anfragetext
- Antworttext
- 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 ( |
Felder | |
---|---|
sessionId |
Erforderlich. Intransparenter, vom Server generierter String, der alle erforderlichen Informationen zur Identifizierung des Play-Spieldienste-Players, des Google-Nutzers und der Anwendung codiert. |
persona |
Erforderlich. Stabile ID des In-Game-Kontos Bitte verwenden Sie nicht dieselbe Persona für verschiedene Spiele. |
token |
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 |
Erforderlich. Kardinalitätsbeschränkung, die beim Verknüpfen einer Persona mit einem Spieler im Rahmen eines Spiels zu beobachten ist. |
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 |
Nur Eingabe. Optionale Ablaufzeit. Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
ttl |
Nur Eingabe. Optionale Gültigkeitsdauer. Eine Dauer in Sekunden mit bis zu neun Nachkommastellen, die auf „ |
Antworttext
Ergebnis eines Versuchs, die Persona zu verknüpfen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"state": enum ( |
Felder | |
---|---|
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
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 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 Wenn bereits vorhandene Links gegen die angegebene Richtlinie verstoßen (was passieren kann, wenn nicht alle |
CREATE_NEW_LINK |
Wenn bereits eine Verknüpfung zwischen einem Spieler und einer Persona vorhanden ist, was zu einem Verstoß gegen die angegebenen 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 |
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. |