- Żądanie HTTP
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- Stan
- Wypróbuj
Powiąż podmiot zabezpieczeń graczy 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 ( |
Pola | |
---|---|
sessionId |
Wymagane. Nieprzezroczysty ciąg znaków wygenerowany przez serwer, który koduje wszystkie informacje niezbędne do identyfikacji odtwarzacza usług gier Play / użytkownika Google i aplikacji. |
persona |
Wymagane. Stabilny identyfikator konta w grze. Nie używaj ponownie tego samego profilu w różnych grach. |
token |
Wymagane. Wartość tokena do utworzenia. Nieprzezroczysty dla Gier Play i uważany za niestabilny (zaszyfrowany z użyciem rotacji kluczy). |
cardinalityConstraint |
Wymagane. Ograniczenie mocy zbioru, które należy obserwować przy łączeniu profilu klienta z graczem w zakresie gry. |
conflictingLinksResolutionPolicy |
Wymagane. Zasada rozwiązywania problemów stosowana, gdy powiązanie profilu klienta z graczem spowodowałoby naruszenie określonego ograniczenia mocy zbioru. |
Pole sumy expiration . Opcjonalny okres ważności tokena lub okres życia. expiration może mieć tylko jedną z tych wartości: |
|
expireTime |
Tylko dane wejściowe. Opcjonalny okres ważności. Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: |
ttl |
Tylko dane wejściowe. Opcjonalny czas życia. Czas trwania w sekundach składający się z maksymalnie 9 cyfr po przecinku, kończący się cyfrą „ |
Treść odpowiedzi
Wynik próby połączenia profilu klienta.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"state": enum ( |
Pola | |
---|---|
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ć przy łączeniu profilu klienta z graczem w zakresie gry.
Wartości w polu enum | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
Moc zbioru 1:1 między profilami w grze a graczami w usługach gier Play. Po zakończeniu operacji łączenia tylko jeden wpis dla odtwarzacza, a profil powinien pozostać w zakresie aplikacji. To, czy zostanie utworzone nowe połączenie, gdy to ograniczenie jest określone, zależy od wybranego elementu
|
ConflictingLinksResolutionPolicy
Zasada rozwiązywania problemów stosowana, gdy powiązanie profilu klienta z graczem spowodowałoby naruszenie określonego ograniczenia mocy zbioru.
Wartości w polu enum | |
---|---|
KEEP_EXISTING_LINKS |
Jeśli połączenia między odtwarzaczem a profilami użytkownika już istnieją, a po utworzeniu nowego połączenia spowodowałoby to naruszenie zasad, zachowaj dotychczasowe. Jeśli na przykład element Persona1-Player1 jest już połączony w zakresie aplikacji1 i próbuje utworzyć nowe połączenie Persona1-Player2 w zakresie aplikacji1, stary link pozostanie bez zmian i nie zostanie dodany nowy. Pamiętaj, że jeśli istniejące linki naruszają określoną zasadę (co może wystąpić, jeśli nie wszystkie wywołania funkcji |
CREATE_NEW_LINK |
Jeśli istnieje już połączenie między odtwarzaczem a profilem klienta, które po utworzeniu nowego połączenia spowodowałoby naruszenie określonego atrybutu Jeśli na przykład element Persona1-Player1 jest już połączony w zakresie aplikacji1 i próbuje utworzyć nowe połączenie Persona1-Player2 w zakresie aplikacji1, stary link zostanie usunięty i dodany nowy, aby je zastąpić. |
Stan
Stan próby połączenia profilu klienta.
Wartości w polu enum | |
---|---|
LINK_CREATED |
Link określony w prośbie został utworzony. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
Link określony w prośbie nie został utworzony, ponieważ istniejące już połączenia spowodowałyby, że nowy link naruszałby RecallTokensCardinalityConstraint . |