Przegląd
Konsola Google Play udostępnia zestaw interfejsów API usług internetowych opartych na architekturze REST, które umożliwiają publikowanie, raportowanie i wykonywanie innych funkcji zarządzania aplikacją bezpośrednio w niej.
Nie wszyscy deweloperzy muszą korzystać z tych interfejsów API – w większości przypadków możesz nadal zarządzać aplikacjami bezpośrednio w Konsoli Google Play. Jeśli jednak masz dużą liczbę plików APK do zarządzania lub musisz śledzić zakupy i subskrypcje użytkowników, te interfejsy API mogą okazać się przydatne.
Usługi w pakiecie
Interfejsy Google Play Developer API pozwalają skupić się na projektowaniu i tworzeniu aplikacji, a jednocześnie poświęcać mniej czasu i wysiłku na zarządzanie wersjami, nawet gdy rozwijasz działalność na nowych rynkach.
Konsola Google Play zawiera zestaw interfejsów API, których możesz używać do zarządzania aplikacją:
- Publishing API umożliwia przesyłanie i publikowanie aplikacji oraz wykonywanie innych zadań związanych z publikowaniem.
- Subscriptions and In-App Purchases API umożliwia zarządzanie zakupami w aplikacji i subskrypcjami. (Ta funkcja była wcześniej znana jako „Purchase Status API”).
- Interfejs API do raportowania umożliwia pobieranie informacji o jakości aplikacji z Android Vitals.
- Reply to Reviews API umożliwia pobieranie opinii o aplikacji i odpowiadanie na nie.
- Permissions API umożliwia automatyzację zarządzania uprawnieniami w Konsoli Play.
- Interfejs Play Games Services Management API umożliwia wysyłanie wywołań REST w celu zautomatyzowanego sterowania metadanymi, które są podstawą funkcji usług gier Google Play.
- Interfejs Voided Purchases API udostępnia listę zamówień powiązanych z zakupami, które użytkownik unieważnił.
Pierwsze kroki
Aby rozpocząć korzystanie z interfejsów Google Play Developer API, zapoznaj się z dokumentacją dotyczącą pierwszych kroków.
Publishing API
Publishing API umożliwia automatyzowanie częstych zadań związanych z dystrybucją aplikacji. Zapewnia funkcje podobne do tych, które są dostępne dla dewelopera w Konsoli Play, takie jak:
- Przesyłanie nowych wersji aplikacji
- publikowanie aplikacji przez przypisywanie plików APK do różnych ścieżek (alfa, beta, wdrażanie etapowe lub produkcyjna);
- tworzenie i modyfikowanie informacji o aplikacji w Sklepie Google Play, w tym zlokalizowanego tekstu i grafiki oraz zrzutów ekranu z różnych urządzeń;
Te zadania są wykonywane za pomocą funkcji edytowania, która stosuje podejście transakcyjne do wprowadzania zmian. Dzięki temu możesz połączyć kilka zmian w jedną wersję roboczą, a następnie zatwierdzić je wszystkie naraz. (Żadne zmiany nie zostaną wprowadzone, dopóki nie zatwierdzisz edycji).
Sprawdzone metody
- Ogranicz liczbę aktualizacji aplikacji. Nie publikuj aktualizacji wersji alfa ani beta częściej niż raz dziennie (aplikacje produkcyjne powinny być aktualizowane jeszcze rzadziej). Każda aktualizacja kosztuje użytkowników czas, a czasem też pieniądze. Jeśli będziesz aktualizować zbyt często, użytkownicy mogą zacząć ignorować aktualizacje, a nawet odinstalować produkt.
Subscriptions and In-App Purchases API
Subscriptions and In-App Purchases API umożliwia zarządzanie katalogiem produktów w aplikacji i subskrypcji. Ponadto dzięki interfejsowi Subscriptions and In-App Purchases API możesz szybko pobrać szczegóły dowolnego zakupu za pomocą standardowego żądania GET.
W żądaniu podajesz informacje o zakupie – nazwę pakietu aplikacji, identyfikator zakupu lub subskrypcji oraz token zakupu. Serwer odpowiada obiektem JSON opisującym powiązane szczegóły zakupu, stan zamówienia, ładunek dewelopera i inne informacje.
Możesz używać tego interfejsu API na kilka sposobów, na przykład:
- raportowanie i uzgadnianie poszczególnych zamówień;
- weryfikowanie zakupów i dat wygaśnięcia subskrypcji;
- uzyskiwanie informacji o anulowanych zamówieniach i potwierdzanie, czy produkty w aplikacji zostały wykorzystane, w tym czy zostały wykorzystane przed anulowaniem;
Sprawdzone metody
- Przechowuj informacje o subskrypcjach na serwerze, aby uniknąć niepotrzebnych wywołań interfejsu API. Gdy aplikacja musi zweryfikować subskrypcję, powinna użyć informacji z pamięci podręcznej na serwerze, zamiast powtarzać wywołanie interfejsu API do Google.
- Istnieją 2 scenariusze, w których bezpieczny serwer powinien używać interfejsu Google Play Developer API do uzyskiwania informacji o subskrypcji:
- Serwer otrzymuje nowy token zakupu, który nie był wcześniej widoczny.
- Twój serwer otrzyma powiadomienie w czasie rzeczywistym dla deweloperów (RTDN), które wskazuje, że musisz użyć tokena zakupu, aby uzyskać nowe informacje o subskrypcji.
- Nie odpytuj interfejsu API o stan subskrypcji w regularnych odstępach czasu. Nie wywołuj na przykład interfejsu API codziennie, aby sprawdzić każdą subskrypcję.
- Powiadomienie RTDN otrzymujesz, gdy subskrypcja wygasa lub zostaje odnowiona, więc nie musisz planować wywołania interfejsu API na podstawie zaplanowanego czasu wygaśnięcia.
Interfejs API do raportowania
Interfejs Reporting API jest przeznaczony dla deweloperów, którzy chcą tworzyć zautomatyzowane przepływy pracy na podstawie danych z Konsoli Play, lub deweloperów, którzy używają danych z Konsoli Play do wewnętrznego raportowania i analizy biznesowej, potencjalnie wraz z innymi zbiorami danych. Zapewnia on automatyczny dostęp do danych i wskaźników na poziomie aplikacji na potrzeby generowania wewnętrznych raportów, przeprowadzania analiz oraz automatyzowania procesów.
Interfejs API do raportowania zapewnia dostęp do danych Android Vitals, w tym częstotliwości awarii, częstotliwości błędów ANR, problemów z wybudzaniem i blokadą uśpienia oraz zrzutów stosu błędów.
Sprawdzone metody
- Ta wersja interfejsu API do raportowania ma domyślny limit 10 zapytań na sekundę. Wykorzystanie limitu możesz sprawdzić w sekcji Limity w konsoli Google Cloud. Jeśli musisz przekroczyć ten limit, prześlij prośbę za pomocą formularza prośby o zwiększenie limitu interfejsu Google Play Developer Reporting API.
Reply to Reviews API
Reply to Reviews API umożliwia wyświetlanie opinii użytkowników o aplikacji i odpowiadanie na nie. Możesz używać tego interfejsu API do bezpośredniej interakcji z użytkownikami w ramach istniejącego zestawu narzędzi obsługi klienta, takiego jak system CRM.
Interfejs Reply to Reviews API umożliwia dostęp do opinii tylko o wersjach produkcyjnych aplikacji. Jeśli chcesz zobaczyć opinie o wersjach alfa lub wersjach beta, użyj Konsoli Google Play. Pamiętaj też, że interfejs API pokazuje tylko opinie zawierające komentarze. Jeśli użytkownik oceni aplikację, ale nie doda komentarza, jego opinia nie będzie dostępna w interfejsie API.
Permissions API
Interfejs Permissions API umożliwia deweloperom automatyzację zarządzania uprawnieniami w Konsoli Play. Dzięki temu możesz elastycznie kontrolować, kto ma dostęp do Twojego konta dewelopera, bez konieczności ręcznego zarządzania.
Za pomocą interfejsu Permissions API możesz wykonywać funkcje administracyjne, takie jak:
- usuwanie dostępu użytkowników, gdy odchodzą z firmy;
- przyznawanie dostępu do aplikacji, gdy użytkownik dołącza do odpowiedniego zespołu;
Voided Purchases API
Interfejs Voided Purchases API udostępnia listę zamówień powiązanych z zakupami, które użytkownik unieważnił. Możesz użyć informacji z tej listy, aby wdrożyć system unieważniania, który uniemożliwi użytkownikowi dostęp do produktów z tych zamówień.
Ten interfejs API dotyczy jednorazowych zamówień w aplikacji i subskrypcji aplikacji.
Zakup można unieważnić na te sposoby:
- Użytkownik prosi o zwrot środków za zamówienie.
- Użytkownik anuluje zamówienie.
- Zamówienie zostało zwrócone.
- Deweloper anuluje zamówienie lub zwraca środki. Uwaga: w Voided Purchases API będą widoczne tylko anulowane zamówienia. Jeśli deweloper zwróci środki bez ustawienia opcji unieważnienia, zamówienia nie będą widoczne w interfejsie API.
- Google anuluje zamówienie lub zwraca środki.
Korzystając z tego interfejsu API, możesz zapewnić bardziej zrównoważone i sprawiedliwe wrażenia wszystkim użytkownikom aplikacji, zwłaszcza jeśli jest to gra.