Przegląd
Konsola Google Play zawiera pakiet interfejsów API usług internetowych opartych na REST, które pozwalają bezpośrednio na potrzeby publikowania, raportowania i wykonywania innych funkcji zarządzania aplikacjami.
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 zarządzasz dużą liczbą plików APK lub musisz śledzić zakupy i subskrypcje użytkowników, te interfejsy API mogą się okazać przydatne.
Kurs obejmuje
Interfejsy Google Play Developer API pozwalają skupić się na projektowaniu i tworzeniu aplikacji, a Ty poświęcasz mniej czasu i wysiłku na zarządzanie wersjami, nawet gdy wejdziesz na nowe rynki.
Konsola Google Play zawiera pakiet interfejsów API, za pomocą których możesz zarządzać swoją aplikacją:
- Interfejs Publishing API umożliwia przesyłanie i publikowanie aplikacji oraz wykonywanie innych zadań związanych z publikowaniem.
- Interfejs API subskrypcji i zakupów w aplikacji umożliwia zarządzanie zakupami i subskrypcjami w aplikacji. (wcześniej ten interfejs nosił nazwę „Interfejs API stanu zakupów”).
- Interfejs API do raportowania umożliwia pobieranie z Android Vitals informacji o jakości aplikacji.
- Interfejs Reply to Reviews API umożliwia pobieranie opinii o aplikacji i odpowiadanie na nie.
- Interfejs Permissions API pozwala zautomatyzować zarządzanie uprawnieniami w Konsoli Play.
- Interfejs Play Games Services Management API umożliwia wywoływanie REST w celu programowego kontrolowania metadanych, na których działają funkcje usług gier Google Play.
- Interfejs Voided Purchases API zapewnia listę zamówień powiązanych z zakupami, które użytkownik unieważnił.
Wprowadzenie
Aby zacząć korzystać z interfejsów Google Play Developer API, zapoznaj się z dokumentacją wprowadzania.
Publishing API
Interfejs Publishing API pozwala zautomatyzować częste zadania związane z dystrybucją aplikacji. Zapewnia to funkcje podobne do tych, które deweloper udostępnia w Konsoli Play, np.:
- Przesyłanie nowych wersji aplikacji
- publikowanie aplikacji przez przypisywanie plików APK do różnych ścieżek (alfa, beta, wdrażania etapowego lub produkcji).
- Tworzenie i modyfikowanie stron aplikacji w Sklepie Google Play, w tym zlokalizowanego tekstu i grafiki oraz zrzutów ekranu z wielu urządzeń
Do wykonywania tych zadań służy funkcja edycji, która wprowadza transakcyjne podejście do wprowadzania zmian. Dzięki temu możesz zebrać kilka zmian w jedną wersję roboczą, a następnie zatwierdzić wszystkie zmiany naraz. (zmiana nie zostanie zastosowana do czasu jej zatwierdzenia).
Sprawdzone metody
- Ogranicz liczbę aktualizacji aplikacji. Nie publikuj aktualizacji alfa ani beta częściej niż raz dziennie (aplikacje produkcyjne powinny być aktualizowane nawet rzadziej). Każda aktualizacja pochłania dla użytkownika czas, a potencjalnie koszty. Jeśli będziesz robić to zbyt często, użytkownicy mogą zacząć ignorować aktualizacje lub nawet odinstalować usługę.
Subscriptions and In-App Purchases API
Interfejs Subskrypcje i zakupy w aplikacji umożliwia zarządzanie katalogiem produktów i subskrypcji w aplikacji. Poza tym interfejsy API subskrypcji i zakupów w aplikacji umożliwiają szybkie pobieranie szczegółów dowolnego zakupu za pomocą standardowego żądania GET.
W prośbie podajesz informacje o zakupie – nazwę pakietu aplikacji, identyfikator zakupu lub subskrypcji oraz token zakupu. Serwer w odpowiedzi przesyła obiekt JSON opisujący powiązane szczegóły zakupu, stan zamówienia, ładunek dewelopera i inne informacje.
Możesz korzystać z tego interfejsu API na kilka sposobów, np. do raportowania i uzgadniania poszczególnych zamówień oraz do weryfikowania zakupów i terminu ważności subskrypcji. W interfejsie API możesz też sprawdzać anulowane zamówienia i sprawdzać, czy produkty w aplikacji zostały wykorzystane, m.in. czy zostały one wykorzystane przed anulowaniem.
Sprawdzone metody
- Przechowuj informacje o subskrypcjach na serwerze, aby uniknąć niepotrzebnych wywołań interfejsu API. Gdy aplikacja musi zweryfikować subskrypcję, korzystaj z informacji znajdujących się w pamięci podręcznej serwera zamiast powtarzać wywołanie interfejsu API do Google.
- Istnieją 2 sytuacje, w których bezpieczny serwer powinien używać interfejsu Google Play Developer API do pobierania informacji o subskrypcjach:
- Serwer otrzymuje nowy token zakupu, który nie został wcześniej wyświetlony.
- Serwer otrzymuje powiadomienie dla deweloperów w czasie rzeczywistym (RTDN) informujące, że musisz użyć tokena zakupu, aby pobrać informacje o nowej subskrypcji.
- Nie regularnie odpytuj interfejsu API pod kątem stanu subskrypcji. Na przykład nie wywołuj interfejsu API codziennie w celu sprawdzenia każdej subskrypcji.
- Ponieważ subskrypcja wygaśnie lub się odnowi, dostajesz RTDN, 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 na podstawie danych z Konsoli Play chcą tworzyć zautomatyzowane przepływy pracy, oraz dla deweloperów, którzy korzystają z danych z Konsoli Play na potrzeby wewnętrznych raportów i analiz biznesowych (potencjalnie razem z innymi zbiorami danych). Ta opcja zapewnia automatyczny dostęp do danych na poziomie aplikacji na potrzeby wewnętrznych raportów, analiz i automatyzacji.
Interfejs API do raportowania zapewnia dostęp do danych Android Vitals, takich jak częstotliwość awarii, częstotliwość błędów ANR, problemy z wybudzaniem i blokadą wybudzenia oraz śledzenie stosu błędów.
Sprawdzone metody
- Ta wersja interfejsu Reporting API ma domyślny limit 10 zapytań na sekundę. Wykorzystanie limitu możesz sprawdzić w sekcji Limity w konsoli Google Cloud. Jeśli chcesz przekroczyć ten limit, możesz przesłać prośbę o zwiększenie limitu za pomocą tego formularza.
Reply to Reviews API
Interfejs Reply to Reviews API pozwala wyświetlać opinie użytkowników o aplikacji i odpowiadać na nie. Za pomocą tego interfejsu API możesz komunikować się z użytkownikami bezpośrednio z poziomu istniejącego zestawu narzędzi do obsługi klienta, np. systemu CRM.
Dzięki interfejsowi Reply to Reviews API możesz uzyskać dostęp do opinii tylko o wersji produkcyjnej aplikacji. Jeśli chcesz zobaczyć opinie na temat wersji alfa lub beta aplikacji, użyj Konsoli Google Play. Pamiętaj też, że interfejs API pokazuje tylko opinie z komentarzami. Jeśli użytkownik oceni aplikację, ale nie doda komentarza, jego opinia nie będzie dostępna z poziomu interfejsu API.
Permissions API
Interfejs Permissions API umożliwia deweloperom zautomatyzowanie zarządzania uprawnieniami w Konsoli Play. W ten sposób możesz elastycznie kontrolować, kto ma dostęp do Twojego konta dewelopera, bez angażowania go.
Za pomocą interfejsu Permissions API możesz wykonywać takie funkcje administracyjne, jak:
- Odbieranie dostępu użytkownikom, którzy opuszczają firmę.
- Przyznanie dostępu do aplikacji, gdy użytkownik dołączy do odpowiedniego zespołu.
Voided Purchases API
Interfejs Voided Purchases API zapewnia 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żliwia użytkownikowi dostęp do produktów z tych zamówień.
Ten interfejs API dotyczy jednorazowych zamówień w aplikacji i subskrypcji.
Zakup można unieważnić na kilka sposobów:
- Użytkownik prosi o zwrot środków za zamówienie.
- Użytkownik anuluje zamówienie.
- Obciążono zwrot środków za zamówienie.
- Deweloper anuluje zamówienie lub zwraca środki. Uwaga: w interfejsie Voided Purchases API widoczne są tylko anulowane zamówienia. W przypadku zwrotu środków bez ustawienia opcji unieważnienia zamówienia nie będą się wyświetlać w interfejsie API.
- Google anuluje zamówienie lub zwraca środki.
Używając tego interfejsu API, możesz zapewnić wszystkim użytkownikom swojej aplikacji bardziej zrównoważone i uczciwe korzystanie z nich, zwłaszcza jeśli jest to gra.