- HTTP-Anfrage
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- Bundesland
- Testen!
Verknüpfe das PGS-Hauptkonto, das in der angegebenen Recall-Sitzungs-ID codiert ist, mit 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 codiert, die zur Identifizierung des Play-Spieldienste-Players, Google-Nutzers und der App erforderlich sind. |
persona |
Erforderlich. Stabile ID des In-Game-Kontos. Verwenden Sie dieselbe Persona nicht für verschiedene Spiele. |
token |
Erforderlich. Wert des zu erstellenden Tokens. Für Play Spiele intransparent und vermutlich nicht stabil (mit Schlüsselrotation verschlüsselt). |
cardinalityConstraint |
Erforderlich. Kardinalitätsbeschränkung, die beim Verknüpfen einer Persona mit einem Spieler im Umfang eines Spiels beachtet werden muss. |
conflictingLinksResolutionPolicy |
Erforderlich. Lösungsrichtlinie, die angewendet wird, wenn die Verknüpfung einer Persona mit einem Spieler zum 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 einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
ttl |
Nur Eingabe. Optionale Gültigkeitsdauer. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
Antworttext
Ergebnis eines Versuchs, eine Persona zu verknüpfen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"state": enum ( |
Felder | |
---|---|
state |
Nur Ausgabe. Status eines Verknüpfungsversuchs mit einer 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 beachtet werden muss.
Enums | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
1:1-Kardinalität zwischen In-Game-Personas und Spielern der Play-Spieldienste. Am Ende des Verknüpfungsvorgangs sollte nur ein Eintrag für den Spieler und die Persona im Geltungsbereich der Anwendung verbleiben. Ob eine neue Verknüpfung erstellt wird, wenn diese Einschränkung angegeben wird, hängt vom ausgewählten
|
ConflictingLinksResolutionPolicy
Lösungsrichtlinie, die angewendet wird, wenn die Verknüpfung einer Persona mit einem Spieler zum Verstoß gegen die angegebene Kardinalitätsbeschränkung führen würde.
Enums | |
---|---|
KEEP_EXISTING_LINKS |
Wenn bereits Links zwischen einem Spieler und einer Persona vorhanden sind, die bei Erstellung der neuen Verknüpfung zu einem Verstoß gegen die angegebene(n) Wenn beispielsweise Persona1-Player1 bereits im Bereich application1 verknüpft ist und versucht wird, im Bereich application1 einen neuen Link Persona1-Player2 zu erstellen, bleibt der alte Link bestehen und es wird kein neuer Link hinzugefügt. Wenn die bereits vorhandenen Links gegen die angegebene Richtlinie verstoßen (was auftreten kann, wenn nicht für alle |
CREATE_NEW_LINK |
Wenn bereits eine Verknüpfung zwischen einem Player und einer Persona besteht und dies zu einem Verstoß gegen die angegebenen Beispiel: Wenn Persona1-Player1 im Bereich application1 bereits verknüpft ist und versucht wird, im Bereich application1 einen neuen Link Persona1-Player2 zu erstellen, wird der alte Link entfernt und der neue Link hinzugefügt, um ihn zu ersetzen. |
Status
Status eines Versuchs, eine Persona zu verknüpfen.
Enums | |
---|---|
LINK_CREATED |
Der in der Anfrage angegebene Link wurde erstellt. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
Der in der Anfrage angegebene Link wurde nicht erstellt, da bereits vorhandene Links dazu führen würden, dass der neue Link bei Erstellung gegen die angegebene RecallTokensCardinalityConstraint verstößt. |