Method: recall.linkPersona

Powiąż podmiot zabezpieczeń odtwarzacza w usługach gier Play zakodowany w podanym identyfikatorze sesji wycofania z kontem w grze

Żądanie HTTP

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

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "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.
}
Pola
sessionId

string

To pole jest wymagane. Nieprzezroczysty ciąg wygenerowany przez serwer, który zawiera wszystkie niezbędne informacje umożliwiające identyfikację odtwarzacza, użytkownika Google i aplikacji Google.
persona

string

To pole jest wymagane. Stabilny identyfikator konta w grze. Nie używaj tej samej osoby w różnych grach.
token

string

To pole jest wymagane. Wartość tokena do utworzenia. Jest nieprzezroczysta dla Gier Play i powinna być niestabilna (szyfrowana za pomocą rotacji klucza).
cardinalityConstraint

enum (RecallTokensCardinalityConstraint)

To pole jest wymagane. Ograniczenie mocy zbioru, które należy obserwować podczas łączenia profilu użytkownika z graczem w zakresie gry.
Pole sumy expiration. Opcjonalny czas wygaśnięcia lub życia tokena. expiration może mieć tylko jedną z tych wartości:
expireTime

string (Timestamp format)

Tylko dane wejściowe. Opcjonalny czas wygaśnięcia.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
ttl

string (Duration format)

Tylko dane wejściowe. Opcjonalny czas życia danych.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

Treść odpowiedzi

Rezultat próby połączenia profilu klienta.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "state": enum (State)
}
Pola
state

enum (State)

Tylko dane wyjściowe. Stan próby połączenia profilu klienta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

RecallTokensCardinalityConstraint

Ograniczenie mocy zbioru, które należy obserwować podczas łączenia profilu użytkownika z graczem w zakresie gry.

Wartości w polu enum
ONE_PERSONA_TO_ONE_PLAYER

Kolaż 1:1 między profilami użytkowników w grze a graczami w usługach gier Play.

Po zakończeniu procesu łączenia tylko jeden wpis dla gracza, a profil aplikacji powinien pozostać w zakresie.

To, czy w przypadku określenia tego ograniczenia ma zostać utworzone nowe połączenie, zależy od wybranej opcji ConflictingLinksResolutionPolicy:

  • Jeśli podasz KEEP_EXISTING_LINKS, a podany profil klienta jest już powiązany z innym graczem lub jest on już powiązany z innym graczem, nie zostanie utworzony nowy link, a już istniejące linki pozostaną niezmienione.

  • Jeśli określono CREATE_NEW_LINK, a podany profil klienta jest już powiązany z innym graczem lub jest on już powiązany z innym graczem, starsze linki zostaną usunięte i zastąpione nowym.

ConflictingLinksResolutionPolicy

Zasady rozwiązywania problemów stosowane, gdy połączenie profilu klienta z graczem spowodowałoby naruszenie określonego ograniczenia dotyczącego mocy zbioru.

Wartości w polu enum

Stan

Stan próby połączenia profilu klienta.

Wartości w polu enum
PERSONA_OR_PLAYER_ALREADY_LINKED Link podany w prośbie nie został utworzony, ponieważ utworzone wcześniej linki spowodowałyby naruszenie określonych zasad RecallTokensCardinalityConstraint.