Metody edycji interfejsu Google Play Developer Publishing API umożliwiają przygotowanie szeregu zmian w aplikacji Google Play, a potem wdrożenie ich wszystkich naraz. Aby to zrobić, utwórz zmianę, która będzie zawierać wszystkie zmiany, które chcesz wprowadzić w aplikacji. Zawiera ona takie informacje jak:
Pliki APK powiązane z aplikacją oraz „ścieżka” dla każdego pliku APK.
Każdy element jest powiązany ze „ścieżką”, która określa, którzy użytkownicy ją zobaczą. Dzięki temu możesz udostępnić swoim testerom wersje alfa i beta aplikacji. Możesz też udostępnić aplikację „wdrażanie etapowe” w ograniczonej wersji. Będzie ona automatycznie udostępniana ograniczonej liczbie użytkowników (określanej na podstawie ustawionego odsetka użytkowników), dzięki czemu możesz stopniowo wdrażać nową wersję produkcyjną aplikacji.
wersje informacji o aplikacji w Sklepie Google Play w zależności od języka i regionu;
Każda wersja informacji o aplikacji w określonej wersji językowej może zawierać zrzuty ekranu i inne grafiki promocyjne, zlokalizowany tekst opisowy itp.
Gdy po raz pierwszy tworzysz zmianę, jest ona kopią bieżącego stanu wdrożonego aplikacji. Możesz ją potem zmodyfikować, wywołując metody Edits. Kiedy zmiana będzie gotowa, zatwierdzasz ją i wprowadzasz zmiany w czasie rzeczywistym. W każdej chwili możesz też zrezygnować z edycji, odrzucić zmiany i pozostawić aplikację w niezmienionej postaci.
Za pomocą tego interfejsu API możesz wprowadzać zmiany w istniejącej aplikacji (która ma przesłany co najmniej 1 plik APK). Zanim użyjesz tego interfejsu API, musisz przesłać co najmniej 1 plik APK za pomocą Konsoli Play. Nie można też używać tego interfejsu API do zmiany stanu aplikacji z „opublikowana” na „nieopublikowana” ani do wypełnienia zgody prawnej wymaganej do opublikowania. Aby opublikować aplikację, musisz użyć Konsoli Play.
Przepływ pracy
W tej sekcji pokazujemy, jak za pomocą metod edycji wprowadzić zmiany w aplikacji za pomocą interfejsu Google Play Developer Publishing API.
Utwórz nową zmianę, wywołując metodę Edits: Insert i określając aplikację, którą chcesz zmodyfikować.
Spowoduje to utworzenie nowej wersji określonej aplikacji. Początkowe ustawienia aplikacji (pliki APK, informacje o aplikacji, pliki rozszerzeń itp.) są kopiowane z wdrożonej wersji aplikacji.
Wprowadź zmiany.
Większość zmian można wprowadzać w Konsoli Google Play. Aby to zrobić, wywołaj odpowiednią metodę interfejsu Google Play Developer API, przekaż identyfikatory aplikacji i wprowadź zmiany, które chcesz zmodyfikować. Oto najważniejsze kwestie:
- Nowe pliki APK możesz przesyłać, wywołując metodę Edits.apks: upload. Plik APK zostanie umieszczony w obszarze pamięci, dzięki czemu można go przypisać do ścieżki w ramach tej lub kolejnej zmiany.
- Pliki APK możesz przypisać do ścieżek, wywołując Edits.tracks:update. Możesz też zmienić przypisania śledzenia dla istniejących plików APK, wywołując metodę Edits.tracks: patch.
- Możesz utworzyć nową zlokalizowaną stronę aplikacji, wywołując Edits.listings: update. Dotychczasowe informacje o aplikacji możesz modyfikować, wywołując metodę Edits.listings: patch.
- Pliki rozszerzeń możesz dodawać i modyfikować, wywołując metody zasobu Edits.expansionfiles.
Te metody wprowadzają zmiany w wprowadzanej przez Ciebie zmianie, ale nie modyfikują opublikowanej wersji aplikacji. Możesz wprowadzać dalsze zmiany lub odrzucić trwające edytowanie bez wpływu na wygodę użytkowników.
Zatwierdź zmianę.
Jeśli po wywołaniu funkcji Edits: approval nie wystąpią błędy weryfikacji, wszystkie zmiany określone w zasobie edytowania są „opublikowane” i zastępują bieżący stan aplikacji. Zastosowanie tych zmian może potrwać kilka godzin, podobnie jak w przypadku wprowadzania zmian w Konsoli Play.