Zmiany

Metody Edits interfejsu Google Play Developer Publishing API umożliwiają przygotowanie wielu zmian w aplikacji w Google Play, a następnie wdrożenie ich wszystkich naraz. W tym celu utwórz zmianę, która zawiera wszystkie zmiany, jakie chcesz wprowadzić w aplikacji. Zmiana zawiera takie informacje jak:

• które pliki APK są powiązane z aplikacją, oraz „ścieżkę” każdego pliku APK.

  Każda z nich jest powiązana ze „ścieżką”, która określa, którym użytkownikom będzie się wyświetlać. Umożliwia to udostępnianie testerom wersji alfa i beta aplikacji. Możesz też udostępnić wersję aplikacji w ramach ograniczonego wydania, czyli „wdrażania etapowego”. Ta aplikacja jest automatycznie udostępniana ograniczonej liczbie użytkowników (określonej przez ustawiony przez Ciebie procent wdrożenia), co pozwala stopniowo wdrażać nową wersję produkcyjną aplikacji.

• wersje strony aplikacji w Sklepie Google Play dostosowane do języka i lokalizacji;

  Każda wersja strony aplikacji dostosowana do danego regionu może zawierać zrzuty ekranu i inne grafiki promocyjne, zlokalizowany tekst opisowy itp.

Uwaga: nie wszystkie metody udostępniane przez interfejs Google Play Developer API korzystają z nowej, transakcyjnej funkcji „edits”. Metody zasobów inappproducts, products i subscriptions wchodzą w życie natychmiast, niezależnie od tego, czy aplikacja jest w trakcie edycji. Na stronie dokumentacji interfejsu API każdego zasobu znajduje się informacja, czy metody tego zasobu korzystają z modelu „edits”.

Gdy po raz pierwszy utworzysz zmianę, będzie ona kopią bieżącego wdrożonego stanu aplikacji. Następnie możesz ją zmodyfikować, wywołując metody Edits. Gdy edycja będzie gotowa, zatwierdź ją, aby wprowadzić zmiany. W każdej chwili możesz też zrezygnować z edytowania, odrzucając zmiany i pozostawiając aplikację w dotychczasowym stanie.

Za pomocą tego interfejsu API możesz wprowadzać zmiany tylko w istniejącej aplikacji (która ma przesłany co najmniej 1 plik APK). Zanim zaczniesz korzystać z tego interfejsu API, musisz przesłać co najmniej 1 plik APK w Konsoli Play. Nie możesz też używać tego interfejsu API do zmiany stanu aplikacji z „opublikowana” na „nieopublikowana” ani do wypełniania wymaganych do publikacji zgód prawnych. Aby opublikować aplikację, musisz użyć Konsoli Play.

Uwaga: jeśli ktoś wprowadzi zmiany w aplikacji w Konsoli Google Play, gdy będziesz edytować aplikację, Twoje zmiany zostaną odrzucone, a zmiany wprowadzone w Konsoli Play zostaną zastosowane.

Przepływ pracy

W tej sekcji pokazujemy typowy sposób korzystania z interfejsu Google Play Developer Publishing API, a konkretnie z metod Edits, do wprowadzania zmian w aplikacji.

1. Utwórz nową zmianę, wywołując 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, strony aplikacji, pliki rozszerzeń itp. – zostaną skopiowane z wdrożonej wersji aplikacji.

2. Wprowadź odpowiednie zmiany.

   Możesz wprowadzać większość zmian, które można wprowadzić w Konsoli Google Play. Aby to zrobić, wywołaj odpowiednią metodę interfejsu Google Play Developer API i przekaż identyfikatory aplikacji i zmiany, które chcesz zmodyfikować. Więcej szczegółów:

   • Nowe pakiety APK możesz przesyłać, wywołując metodę Edits.apks: upload. Spowoduje to umieszczenie pliku APK w obszarze pamięci, dzięki czemu będzie można go przypisać do ścieżki w tej lub kolejnej edycji.
   • Aby przypisać pliki APK do ścieżek, wywołaj funkcję Edits.tracks:update. Możesz też zmienić przypisania ścieżek do istniejących plików APK, wywołując metodę Edits.tracks:patch.
   • Aby utworzyć nowe zlokalizowane informacje o aplikacji, wywołaj metodę Edits.listings: update. Możesz zmodyfikować istniejącą kartę aplikacji, wywołując metodę Edits.listings: patch.
   • Pliki rozszerzające możesz dodawać lub modyfikować, wywołując metody zasobu Edits.expansionfiles.

   Te metody wprowadzają zmiany w edytowanej wersji, ale nie modyfikują wersji aplikacji dostępnej dla użytkowników. Możesz wprowadzić dalsze zmiany lub odrzucić edytowaną wersję bez wpływu na wrażenia użytkowników.

   Uwaga: każdy użytkownik może mieć otwartą tylko jedną edycję naraz. Jeśli utworzysz nową zmianę, wszystkie otwarte zmiany zostaną unieważnione. Dodatkowo, jeśli ktoś wprowadzi zmiany w aplikacji w Konsoli Play, wszystkie inne zmiany w aplikacji (należące do dowolnego użytkownika) zostaną unieważnione. Jeśli spróbujesz zatwierdzić nieprawidłową zmianę, operacja zgłosi wyjątek i nie będzie miała żadnego wpływu.

3. Zatwierdź zmianę.

   Jeśli po wywołaniu Edits: commit nie ma błędów weryfikacji, wszystkie zmiany określone w zasobie edits zostaną wprowadzone i zastąpią bieżący stan aplikacji. Zastosowanie tych zmian może potrwać kilka godzin, tak jak w przypadku zmian wprowadzanych w Konsoli Play.