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żej znajdziesz 4 kroki, które trzeba wykonać, aby zacząć korzystać z interfejsu Google Play Developer API.
- Połącz konto dewelopera z nowym lub istniejącym projektem Google Cloud.
- Włącz interfejs Google Play Developer API w połączonym projekcie Google Cloud.
- Autoryzuj klucz interfejsu API Google Play Developer API w połączonym projekcie Google Cloud.
- Skonfiguruj konto usługi z odpowiednimi uprawnieniami Konsoli Google Play, aby uzyskać dostęp do interfejsu Google Play Developer API.
Łączenie konta i projektu
Aby uzyskać dostęp do interfejsu Google Play Developer API, musisz połączyć swoje konto dewelopera w Google Play z projektem Google Cloud. W większości przypadków zalecamy utworzenie nowego projektu Google Cloud przeznaczonego dla Twojego konta dewelopera w Google Play, ale możesz połączyć dotychczasowy. Pamiętaj, że każde konto dewelopera w Google Play można połączyć tylko z jednym projektem Google Cloud. Jeśli na tym samym koncie dewelopera w Google Play masz wiele aplikacji, wszystkie muszą korzystać z tego samego projektu Google Cloud.
Utwórz nowy projekt
- Wejdź na stronę Dostęp do interfejsów API w Konsoli Google Play.
- Kliknij Utwórz nowy projekt.
Projekt Google Cloud zostanie utworzony automatycznie i połączony z Twoim kontem dewelopera w Google Play.
Użyj istniejącego projektu
Jeśli jesteś już użytkownikiem Google Cloud Console, możesz połączyć swój istniejący projekt Google Cloud, wykonując te czynności:
- Wejdź na stronę Dostęp do interfejsów API w Konsoli Google Play.
- Wybierz projekt, który chcesz połączyć. Jeśli Twój projekt nie jest widoczny, sprawdź, czy konto użytkownika jest oznaczone w projekcie Google Cloud jako właściciel, który chcesz połączyć.
- Kliknij Połącz dotychczasowy projekt.
Włączanie interfejsu API
Po skonfigurowaniu połączonego projektu Google Cloud musisz włączyć w tym projekcie interfejs Google Play Developer API. Aby to zrobić, musisz być właścicielem projektu Google Cloud.
- Wejdź na stronę Dostęp do interfejsów API w Konsoli Google Play.
- W sekcji Interfejsy API znajdź interfejs Google Play Developer API i kliknij Włącz.
Spowoduje to natychmiastowe zaktualizowanie projektu Google Cloud i wprowadzenie zmian od razu.
Autoryzowanie klucza interfejsu API
Aby korzystać z interfejsu API, potrzebujesz klucza interfejsu API w połączonym projekcie Google Cloud autoryzowanym do korzystania z interfejsu Google Play Developer API. Skonfiguruj tę opcję w Konsoli Google Play.
Skonfiguruj OAuth i Konta 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 należy użyć konta usługi, aby uzyskać dostęp do interfejsu API.
Konta usługi muszą być używane w bezpiecznym środowisku, takim jak serwer. Dane logowania na konto usługi muszą być zarządzane w bezpieczny sposób, aby nie były ujawniane osobom nieupoważnionym do używania tego interfejsu API.
Identyfikator Client OAuth powinien być używany, jeśli chcesz korzystać z interfejsu API w imieniu użytkownika. Jeśli np. Twoja witryna musi mieć dostęp do interfejsu Google Play Developer API w imieniu klienta internetowego, możesz używać identyfikatora klienta. Użytkownik zostanie uwierzytelniony za pomocą konta Google, a nie konta usługi. Umożliwi to wykonywanie wywołań interfejsu API w imieniu użytkownika bez negatywnego wpływu na dane logowania do konta usługi.
- Konto usługi: zabezpieczona usługa oprogramowania uzyska dostęp do interfejsu API (najczęstsza metoda)
- Klienty OAuth: użytkownik uzyskuje dostęp do interfejsu API
Użyj konta usługi
Konto usługi możesz utworzyć w Konsoli Google Play.
- Wejdź na stronę Dostęp do interfejsów API w Konsoli Google Play.
- W sekcji Konta usługi kliknij Dowiedz się, jak utworzyć konta usługi.
Postępuj zgodnie z instrukcjami, aby utworzyć konto usługi.
Aby konto usługi było widoczne w Konsoli Google Play, podczas jego tworzenia musisz przyznać kontu usługi dostęp do projektu Google Cloud.
Po utworzeniu konta usługi w Konsoli Google Play kliknij Gotowe. Sekcja Konta usługi na stronie Dostęp do interfejsu API zostanie automatycznie odświeżona, a Twoje konto usługi zostanie wyświetlone.
Kliknij Przyznaj dostęp, aby przyznać kontu usługi uprawnienia wymagane do wykonania 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
Na tym koncie możesz już korzystać z interfejsu Google Play Developer API. Więcej informacji znajdziesz w artykule Korzystanie z OAuth 2.0 dla aplikacji między serwerami.
Korzystanie z klientów OAuth
Możesz zezwolić użytkownikom na wykonywanie działań przy użyciu interfejsu API przy użyciu własnych danych logowania przy użyciu klienta OAuth. Działania użytkownika są ograniczone do działań dozwolonych na stronie Użytkownicy i uprawnienia w Konsoli Google Play.
Zanim utworzysz klienty OAuth, musisz skonfigurować informacje o marce. Więcej informacji znajdziesz w artykule Konfigurowanie ekranu zgody OAuth.
- Wejdź na stronę Dostęp do interfejsów API w Konsoli Google Play.
- W sekcji Klienty OAuth kliknij Skonfiguruj ekran zgody OAuth.
- Skonfiguruj informacje o marce swojego produktu.
- Gdy skończysz, kliknij Odśwież zgodę OAuth. Sekcja zostanie zaktualizowana, a komunikat o budowaniu marki nie będzie już wyświetlany.
Aby utworzyć klienta OAuth przy użyciu Konsoli Google Play:
- Wejdź na stronę Dostęp do interfejsów API w Konsoli Google Play.
- W sekcji Klienty OAuth kliknij Utwórz nowego klienta OAuth.
- Wykonaj instrukcje podane na stronie, aby utworzyć klienta OAuth.
Po utworzeniu klienta OAuth w Konsoli Google Play kliknij Gotowe. Sekcja Klienty OAuth na stronie Dostęp API jest automatycznie odświeżana, a klient OAuth jest wymieniony na liście.
Czasami nowy klient OAuth nie jest widoczny na stronie. W takim przypadku kliknij Odśwież klienty OAuth.
Szczegółowe informacje o nowym kliencie OAuth zostaną wyświetlone na liście na tej stronie.
Dodatkowe informacje
Skorzystaj z tych porad i wskazówek, aby zacząć korzystać z interfejsu API w Google Play.
Uzyskiwanie identyfikatora programisty
Niektóre interfejsy API wymagają podania identyfikatora dewelopera w Konsoli Google Play. To długi numer przypisany podczas tworzenia konta dewelopera w Google Play. Identyfikator programisty znajdziesz w adresie URL niemal każdej strony w Konsoli Google Play, np. strony dostępu do interfejsu API.
Weźmy na przykład adres URL Konsoli Google Play:
https://play.google.com/console/developers/1234567890123456789/api-access
W tym adresie URL będzie widoczny identyfikator dewelopera: 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 musisz użyć identyfikatora dewelopera nowego konta dewelopera w Google Play w wywołaniach interfejsu API związanych z tą aplikacją.
Specjalne interfejsy API
Interfejs Google Play Developer API zawiera kilka specjalistycznych interfejsów API, które umożliwiają analizę określonych typów aplikacji:
- Interfejs API odpowiedzi na opinie
- Ta funkcja umożliwia wyświetlanie opinii użytkowników na temat aplikacji i udzielanie odpowiedzi.
- Interfejs API Voided Purchases
- Umożliwia unieważnienie dostępu do produktów w aplikacji związanych z unieważnionymi zakupami.
Biblioteki klienta
Udostępniliśmy biblioteki klienta, które umożliwiają programowy dostęp do interfejsów API REST. Więcej informacji znajdziesz w sekcji Biblioteki klienta i próbki kodu.