- Żądanie HTTP
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- Stan
- Wypróbuj
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 ( |
Pola | |
---|---|
sessionId |
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 |
To pole jest wymagane. Stabilny identyfikator konta w grze. Nie używaj tej samej osoby w różnych grach. |
token |
To pole jest wymagane. Wartość tokena do utworzenia. Jest nieprzezroczysta dla Gier Play i powinna być niestabilna (szyfrowana za pomocą rotacji klucza). |
cardinalityConstraint |
To pole jest wymagane. Ograniczenie mocy zbioru, które należy obserwować podczas łączenia profilu użytkownika z graczem w zakresie gry. |
conflictingLinksResolutionPolicy |
To pole jest wymagane. Zasady rozwiązywania problemów stosowane, gdy połączenie profilu klienta z graczem spowodowałoby naruszenie określonego ograniczenia dotyczącego mocy zbioru. |
Pole sumy expiration . Opcjonalny czas wygaśnięcia lub życia tokena. expiration może mieć tylko jedną z tych wartości: |
|
expireTime |
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: |
ttl |
Tylko dane wejściowe. Opcjonalny czas życia danych. Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
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 ( |
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ć 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
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 | |
---|---|
KEEP_EXISTING_LINKS |
Jeśli między graczem a profilem użytkownika istnieją już powiązania, co w przypadku utworzenia nowego linku spowodowałoby naruszenie określonych zasad Jeśli na przykład profil osobisty1-odtwarzacz1 jest już połączony w zakresie app1 i próbowano utworzyć nowy link Persona1-Player2 w zakresie app1 z ograniczeniem Pamiętaj, że jeśli istniejące już linki naruszają określoną zasadę (co może się zdarzyć, jeśli nie wszystkie wywołania funkcji |
CREATE_NEW_LINK |
Jeśli istnieje już powiązanie między graczem a profilem klienta, co w przypadku utworzenia nowego linku spowodowałoby naruszenie określonej zasady Jeśli na przykład profil osobisty1-Player1 jest już połączony w zakresie app1 i próbuje utworzyć nowy link „Persona1-Player2” w zakresie aplikacja1 z ograniczeniem |
Stan
Stan próby połączenia profilu klienta.
Wartości w polu enum | |
---|---|
LINK_CREATED |
Utworzono link podany w prośbie. |
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 . |