Czasami możesz chcieć wyświetlić i edytować projekt usług gier Play bezpośrednio w Google Cloud.
Typowe scenariusze:
- włączanie dodatkowych interfejsów API w projekcie (np. Dysku Google);
- Edytowanie informacji o marce gry w oknie OAuth 2.0.
- wyświetlanie limitu interfejsu API i w razie potrzeby przesyłanie prośby o dodatkowy limit;
- Edytowanie autoryzowanych identyfikatorów URI lub źródeł JavaScript w identyfikatorach klientów utworzonych w przeszłości.
Wyświetlanie projektu
Aby wyświetlić projekt w Google Cloud:
- Na stronie Konfiguracja (Zwiększanie liczby użytkowników > Usługi gier Play > Konfiguracja i zarządzanie > Konfiguracja) wybierz dane logowania do gry.
- Przejdź do sekcji Uwierzytelnianie i kliknij Wyświetl w Google Cloud.
Dostosowywanie limitów wykorzystania interfejsu API
W Google Cloud możesz wyświetlić limity wykorzystania interfejsu API skonfigurowane dla Twojej gry oraz ilość wykorzystanego limitu. Możesz też ustawić limity dla poszczególnych użytkowników, aby zapobiec wyczerpaniu limitu przez użytkownika naruszającego zasady (lub przez klienta gry z błędami).
Aby wyświetlić lub zmienić limity wykorzystania w projekcie albo poprosić o zwiększenie limitu:
- Jeśli nie masz jeszcze konta rozliczeniowego dla projektu, utwórz je.
- Otwórz stronę Włączone interfejsy API w bibliotece interfejsów API w Konsoli interfejsów API i wybierz interfejs API z listy.
- Aby wyświetlić i zmienić ustawienia związane z limitami, kliknij Limity. Aby wyświetlić statystyki użytkowania, kliknij Użycie.
Pamiętaj, że „użytkownicy” są określani na podstawie adresu IP klienta wysyłającego żądanie limitu. Jeśli na przykład wszystkie żądania pochodzą z jednego serwera, może on zostać błędnie oznaczony jako jeden użytkownik wysyłający spam. Aby temu zapobiec, możesz dołączyć argument userIp=x.x.x.x do żądań punktów końcowych interfejsu API.
Więcej informacji o ustawianiu limitów dla poszczególnych użytkowników znajdziesz w artykule Ograniczanie wykorzystania interfejsu API.
Oprócz limitu na użytkownika istnieje limit dzienny dla całego interfejsu API usług Gier Google Play. Zwykle nie musisz zmieniać wstępnie przydzielonego limitu. Jeśli jednak przewidujesz duży wzrost liczby żądań (np. w przypadku zbliżającego się wydarzenia), możesz poprosić o dodatkowy limit, klikając link Poproś o więcej.
Aktywowanie innych interfejsów API
Gdy utworzysz identyfikator klienta w Konsoli Play, interfejs API usług Gier Google Play zostanie automatycznie włączony w Twoim projekcie. Inne interfejsy API Google możesz aktywować w Google Cloud.
Aby włączyć interfejs API w projekcie:
Otwórz Bibliotekę interfejsów API w Konsoli interfejsów API Google. Jeśli pojawi się monit, wybierz projekt lub utwórz nowy. Biblioteka interfejsów API zawiera listę wszystkich dostępnych interfejsów API pogrupowanych według rodziny produktów i popularności.
Jeśli interfejsu API, który chcesz włączyć, nie ma na liście, wyszukaj go.
Wybierz interfejs API, który chcesz włączyć, a następnie kliknij przycisk Włącz.
Jeśli pojawi się taka prośba, włącz płatności.
Jeśli pojawi się taka prośba, zaakceptuj warunki korzystania z interfejsu API.
Zmiana informacji o marce
Aby zmodyfikować informacje o marce (tytuł, logo itp.) gry, które pojawiają się w oknie OAuth 2.0, ustaw atrybuty na ekranie zgody w Google Cloud.
Aby skonfigurować ekran zgody w projekcie:
- Otwórz stronę ekranu zgody w Konsoli Play. Jeśli pojawi się monit, wybierz projekt lub utwórz nowy.
- Wypełnij formularz i kliknij Zapisz.
Modyfikowanie typu użytkownika OAuth
Jeśli testujesz w ramach ścieżki testowej Wersja produkcyjna (Testowanie i wdrażanie > Wersja produkcyjna) przy użyciu osobistego konta testowego, musisz też skonfigurować ustawienie odbiorców OAuth w Google Cloud jako Zewnętrzne. Więcej informacji znajdziesz w artykule Zarządzanie odbiorcami aplikacji.
Modyfikowanie atrybutów związanych z identyfikatorem klienta
Aby zmodyfikować atrybuty związane z identyfikatorem klienta OAuth 2.0 (pochodzenie internetowe i adresy URL przekierowania w przypadku aplikacji internetowej itp.):
- Otwórz Konsolę Play i przejdź do swojej gry.
- Na stronie Konfiguracja (Zwiększanie liczby użytkowników > Usługi gier Play > Konfiguracja i zarządzanie > Konfiguracja) wybierz dane logowania do gry.
- Przewiń w dół do sekcji Uwierzytelnianie i kliknij Wyświetl w Google Cloud.
- W Google Cloud wybierz swój projekt.
- Na pasku bocznym po lewej stronie wybierz Interfejsy API i uwierzytelnianie. Sprawdź, czy na wyświetlonej liście interfejsów API stan interfejsu API usług Gier Google Play to WŁĄCZONY.
- Na pasku bocznym po lewej stronie wybierz Zarejestrowane aplikacje.
- Rozwiń sekcję Identyfikator klienta OAuth 2.0 i znajdź atrybut, który chcesz edytować.
Migracja klientów OAuth z istniejącego projektu w chmurze
Aby wyświetlić projekt w Google Cloud, wykonaj czynności opisane w sekcji Wyświetlanie projektu.
Do skonfigurowania usług Gier Play (PGS) wymagany jest unikalny projekt w chmurze Google. Jeśli kilka gier korzysta z jednego projektu w chmurze, musisz przenieść ich klienty OAuth na Androida do niezależnych projektów, aby zapewnić prawidłową konfigurację.
W powyższym przykładzie Gry 1 i Gra 2 utworzyły klientów internetowych i na Androida w ramach jednego projektu w chmurze Google na potrzeby logowania przez Google. Musimy przenieść klientów internetowych i klientów na Androida z gry 2 z bieżącego starszego projektu Google Cloud do nowego docelowego projektu Google Cloud.
Krok 1. Przygotowanie backendu
Zanim to zrobisz, musisz dostosować backend i klientów, aby obsługiwały jednoczesne istnienie starych i nowych identyfikatorów klienta internetowego.
- Konfiguracja po stronie serwera: jeśli serwer weryfikuje identyfikator klienta internetowego w tokenie identyfikatora, musisz zaktualizować logikę po stronie serwera, aby jednocześnie obsługiwała tokeny identyfikatora wydawane zarówno przez starych klientów w starszym projekcie w Google Cloud, jak i przez nowych klientów, których musisz wygenerować w docelowym projekcie w Google Cloud.
- Konfiguracja po stronie klienta: aplikacja kliencka musi obsługiwać wiele identyfikatorów klienta internetowego, aby można było logować się przy użyciu nowego identyfikatora klienta internetowego podczas przełączania. Możesz użyć dowolnej z tych metod:
- Wbudowane 2 identyfikatory klienta internetowego w aplikacji klienckiej, przełączanie na nowy identyfikator klienta internetowego po wygaśnięciu starego identyfikatora klienta
- Dynamiczne pobieranie najnowszego identyfikatora klienta internetowego z serwera w celu ukończenia przełączania
- Wcześniejsze utworzenie klientów internetowych: w projekcie docelowym musisz wcześniej utworzyć nowego klienta internetowego, aby uniknąć potencjalnych opóźnień podczas przełączania atomowego.
Krok 2. Skonfiguruj nowych klientów OAuth w internecie i na Androidzie w odpowiedniej usłudze Google Cloud
Krok 2.1. Utwórz nowego klienta OAuth w usłudze internetowej dla Gry 2 w docelowym projekcie Google Cloud:
Krok 2.2: Ostrzeżenie: zmodyfikowanie klienta Androida uniemożliwi użytkownikom gry logowanie się w niej za pomocą funkcji Zaloguj się przez Google. Dlatego po wykonaniu kroku 2.2 musisz od razu przejść do kroku 2.3. Aby zminimalizować odstęp czasu między modyfikacją a ponownym utworzeniem, zalecamy otwieranie 2 stron internetowych jednocześnie.
Zmień nazwę pakietu klienta Androida gry 2 w projekcie Google Cloud starszego typu na nieprawidłową wartość, np. com.noexist.none.
Krok 2.3. Natychmiast utwórz nowego klienta Androida dla Gry 2 z tym samym odciskiem cyfrowym SHA-1 i nazwą pakietu Gry 2 w docelowym projekcie Google Cloud:
Krok 3. Wdrażanie konfiguracji w czasie rzeczywistym
Po utworzeniu nowego klienta Androida w projekcie docelowym wykonaj od razu te czynności:
- Przekieruj klientów: użyj mechanizmu konfiguracji dynamicznej (np. Zdalnej konfiguracji), aby natychmiast przełączyć aplikację klienta tak, aby zaczęła używać nowego identyfikatora klienta internetowego.
- Zachowaj starych klientów: zachowaj starych klientów OAuth jako opcję rezerwową, aby w razie problemów móc wycofać zmiany do poprzedniego logowania klienta OAuth.