Zanim zaczniesz wykonywać wywołania interfejsu API, musisz skonfigurować dostęp do interfejsu API do swojego konta dewelopera w Google Play. Wiąże się to ze zmianami zarówno w Konsoli Google Play, jak i w Konsoli Google Cloud. Poniżej znajdziesz instrukcje, jak zacząć korzystać z interfejsu Google Play Developer API.
- Utwórz projekt Google Cloud.
- Włącz interfejs Google Play Developer API w projekcie Google Cloud.
- Aby uzyskać dostęp do interfejsu Google Play Developer API, skonfiguruj konto usługi z odpowiednimi uprawnieniami w Konsoli Google Play.
Utwórz projekt Google Cloud
Możesz pominąć ten krok, jeśli masz już projekt Google Cloud, którego chcesz użyć.
Utwórz projekt w konsoli Google Cloud.
Więcej informacji o projektach Google Cloud znajdziesz w artykule Tworzenie projektów i zarządzanie nimi.
Włącz API
Po skonfigurowaniu projektu Google Cloud musisz włączyć w nim interfejs Google Play Developer API.
Aby włączyć interfejs Google Play Developer API:
- Otwórz stronę interfejsu Google Play Developer API w Google Cloud Console.
- Kliknij Włącz.
Skonfiguruj OAuth i konta usługi
Dostęp do interfejsu Google Play Developer API musisz skonfigurować za pomocą klienta OAuth lub konta usługi. Aby uzyskać dostęp do interfejsu API, w większości przypadków należy użyć konta usługi.
Konta usługi muszą być używane w bezpiecznym środowisku, np. na serwerze. Dane logowania do konta usługi muszą być zarządzane w bezpieczny sposób, aby nie zostały ujawnione osobom, które nie mają uprawnień do korzystania z interfejsu API.
Identyfikatora klienta OAuth należy używać, jeśli chcesz uzyskać dostęp do interfejsu API w imieniu pojedynczego użytkownika. Jeśli na przykład Twoja witryna musi w imieniu użytkownika uzyskiwać dostęp do interfejsu Google Play Developer API z poziomu klienta internetowego, możesz użyć identyfikatora klienta. Użytkownik zostanie uwierzytelniony za pomocą konta Google, a nie konta usługi. Dzięki temu możesz wykonywać wywołania interfejsu API w imieniu użytkownika bez naruszania danych logowania do konta usługi.
- Konto usługi: bezpieczna usługa oprogramowania będzie mieć dostęp do interfejsu API (najczęściej używana usługa).
- Klienty OAuth: użytkownik uzyska dostęp do interfejsu API
Użyj konta usługi
Konto usługi możesz utworzyć w Konsoli Google Play.
- W konsoli Google Cloud wybierz Konta usługi.
- Kliknij Utwórz konto usługi i postępuj zgodnie z instrukcjami.
- W Konsoli Google Play otwórz stronę Użytkownicy i uprawnienia.
- Kliknij Zaproś nowych użytkowników.
Wpisz adres e-mail konta usługi w polu adresu e-mail i przyznaj niezbędne uprawnienia do wykonywania czynności.
Aby korzystać z interfejsów API Płatności w Google Play, musisz przyznać te uprawnienia:
- Wyświetlanie danych finansowych, zamówień i odpowiedzi z ankiety na temat anulowania
- Zarządzanie zamówieniami i subskrypcjami
Kliknij Zaproś użytkownika.
Od tej pory dostęp do interfejsu Google Play Developer API możesz uzyskać z konta usługi. Więcej informacji znajdziesz w artykule o używaniu OAuth 2.0 w aplikacjach międzyserwerowych.
Używanie klientów OAuth
Możesz zezwolić użytkownikom na wykonywanie czynności przy użyciu interfejsu API z użyciem własnych danych logowania przy użyciu klienta OAuth. Działania użytkownika są ograniczone do tych, które są dozwolone na stronie Użytkownicy i uprawnienia w Konsoli Google Play.
Zanim utworzysz klientów OAuth, musisz skonfigurować informacje o marce swojej usługi. Więcej informacji znajdziesz w artykule Konfigurowanie ekranu zgody OAuth.
- W konsoli Google Cloud otwórz stronę ekranu zgody OAuth.
- Postępuj zgodnie z instrukcjami, aby utworzyć ekran zgody OAuth.
Aby utworzyć klienta OAuth:
- W konsoli Google Cloud otwórz Dane logowania.
- Kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
- Wybierz typ aplikacji i postępuj zgodnie z instrukcjami.
Informacje dodatkowe
Skorzystaj z poniższych wskazówek i wskazówek, które pomogą Ci zacząć korzystać z interfejsu API w Google Play.
Uzyskiwanie identyfikatora dewelopera
Niektóre interfejsy API wymagają podania identyfikatora dewelopera Konsoli Google Play. Jest to długi numer przypisany podczas tworzenia konta dewelopera w Google Play. Identyfikator dewelopera można znaleźć w adresie URL niemal każdej strony w Konsoli Google Play, na przykład na stronie Dostęp do interfejsu API.
Przeanalizujmy ten przykładowy adres URL Konsoli Google Play:
https://play.google.com/console/developers/1234567890123456789/api-access
W tym adresie URL identyfikatorem dewelopera byłoby 1234567890123456789
.
Uwaga: jeśli aplikacja zostanie przeniesiona z jednego konta dewelopera w Google Play na inne, zmieni się powiązany z nią identyfikator dewelopera. Oznacza to, że po zakończeniu przenoszenia w wywołaniach interfejsu API tej aplikacji musisz używać identyfikatora dewelopera do nowego konta dewelopera w Google Play.
Specjalistyczne interfejsy API
Interfejs Google Play Developer API zawiera kilka wyspecjalizowanych interfejsów API, które pozwalają przeprowadzać określone rodzaje analiz aplikacji:
- Interfejs Reply to Reviews API
- Umożliwia wyświetlanie opinii użytkowników o aplikacji i odpowiadanie na te opinie.
- Voided Purchases API
- Umożliwia cofnięcie dostępu do produktów w aplikacji powiązanych z zakupami, które użytkownik unieważnił.
Biblioteki klienta
Udostępniliśmy biblioteki klienta, których możesz używać do automatycznego dostępu do interfejsów API REST. Więcej informacji znajdziesz w artykule Biblioteki klienta i przykłady kodu.