Zanim zaczniesz wykonywać wywołania interfejsu API, musisz skonfigurować dostęp do interfejsu API na swoim koncie dewelopera w Google Play. Obejmuje to zmiany zarówno w Konsoli Google Play, jak i w Google Cloud Console. Poniższe instrukcje opisują czynności, które należy wykonać, aby zacząć korzystać z interfejsu Google Play Developer API.
- Utwórz projekt Google Cloud.
- włączyć interfejs Google Play Developer API w projekcie Google Cloud;
- Skonfiguruj konto usługi z odpowiednimi uprawnieniami w Konsoli Google Play, aby uzyskać dostęp do interfejsu Google Play Developer API.
Tworzenie projektu Google Cloud
Możesz pominąć ten krok, jeśli masz już projekt Google Cloud, którego chcesz użyć.
Utwórz projekt w Google Cloud Console.
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 konsoli Google Cloud.
- Kliknij Włącz.
Konfigurowanie OAuth i kont usługi
Musisz skonfigurować dostęp do interfejsu Google Play Developer API za pomocą klienta OAuth lub konta usługi. W większości przypadków do uzyskania dostępu do interfejsu API należy używać konta usługi.
Konta usługi muszą być używane w bezpiecznym środowisku, np. na serwerze. Dane logowania konta usługi muszą być bezpiecznie zarządzane, aby nie zostały ujawnione osobom, które nie są uprawnione do korzystania z interfejsu API.
Identyfikator klienta OAuth należy używać, jeśli chcesz uzyskać dostęp do interfejsu API w imieniu konkretnego użytkownika. Jeśli na przykład Twoja witryna musi uzyskiwać dostęp do interfejsu Google Play Developer API z klienta internetowego w imieniu użytkownika, możesz użyć identyfikatora klienta. Użytkownik zostanie uwierzytelniony za pomocą konta Google zamiast konta usługi. Umożliwia to wywoływanie interfejsu API w imieniu użytkownika bez narażania danych logowania konta usługi.
- Konto usługi: bezpieczna usługa oprogramowania będzie uzyskiwać dostęp do interfejsu API (najczęstsze rozwiązanie).
- Klienci OAuth: użytkownik będzie uzyskiwać dostęp do interfejsu API
Używanie konta usługi
Konto usługi możesz utworzyć w Konsoli Google Play.
- W konsoli Google Cloud otwórz Konta usługi.
- Kliknij Utwórz konto usługi i wykonaj podane czynności.
- Otwórz stronę Użytkownicy i uprawnienia w Konsoli Google Play.
- 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 działań.
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.
W tym momencie powinna być możliwość uzyskania dostępu do interfejsu Google Play Developer API za pomocą konta usługi. Więcej informacji znajdziesz w artykule o używaniu protokołu OAuth 2.0 w aplikacjach międzyserwerowych.
Korzystanie z klientów OAuth
Możesz zezwolić użytkownikom na wykonywanie działań za pomocą interfejsu API przy użyciu ich własnych danych logowania za pomocą klienta OAuth. Działania użytkownika są ograniczone do tych, na które zezwalają ustawienia na stronie Użytkownicy i uprawnienia w Konsoli Google Play.
Zanim utworzysz klientów OAuth, musisz skonfigurować informacje o marce dla 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.
Dodatkowe informacje
Zapoznaj się z poniższymi wskazówkami i trikami, które pomogą Ci zacząć korzystać z interfejsów API w Google Play.
Uzyskiwanie identyfikatora dewelopera
Niektóre interfejsy API wymagają podania identyfikatora dewelopera w Konsoli Google Play. Jest to długi numer, który został przypisany podczas tworzenia konta dewelopera w Google Play. Identyfikator dewelopera znajdziesz w adresie URL niemal każdej strony w Konsoli Google Play, np. na stronie Dostęp do interfejsu API.
Weźmy na przykład adres URL Konsoli Google Play:
https://play.google.com/console/developers/1234567890123456789/api-access
W powyższym adresie URL identyfikator dewelopera to 1234567890123456789.
Uwaga: jeśli aplikacja zostanie przeniesiona z jednego konta dewelopera w Google Play na inne, identyfikator dewelopera powiązany z tą aplikacją ulegnie zmianie. Oznacza to, że po zakończeniu przenoszenia w wywołaniach interfejsu API dotyczących tej aplikacji musisz używać identyfikatora dewelopera z nowego konta dewelopera w Google Play.
Specjalistyczne interfejsy API
Interfejs Google Play Developer API zawiera kilka specjalistycznych interfejsów API, które umożliwiają przeprowadzanie określonych typów analiz aplikacji:
- Reply to Reviews API
- Umożliwia wyświetlanie opinii użytkowników o aplikacji i odpowiadanie na nie.
- Voided Purchases API
- Umożliwia cofnięcie dostępu do produktów w aplikacji powiązanych z zakupami, które użytkownik anulował.
Biblioteki klienta
Udostępniamy biblioteki klienta, których możesz używać do programowego dostępu do interfejsów API REST. Więcej informacji znajdziesz w sekcji Biblioteki klienta i przykłady kodu.