Ten dokument zawiera informacje o wersji interfejsów Google Play Developer API.
19 listopada 2026 r.
Nowe funkcje
Oferty dla obecnych subskrybentów: możesz teraz tworzyć oferty dla obecnych subskrybentów, które Google Play będzie wyświetlać kwalifikującym się subskrybentom, gdy będą próbowali anulować subskrypcję.
- Kierowanie na utrzymanie: aby utworzyć lub zaktualizować ofertę na utrzymanie za pomocą metody
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patchlubmonetization.subscriptions.basePlans.offers.batchUpdate, ustawretentionRulew polutargetingoferty na obiektRetentionTargetingRule. Użyj pólscope,minDuration,allowMultipleClaimsiminOfferCooldownDuration, aby określić, którzy subskrybenci kwalifikują się do skorzystania z oferty i czy mogą z niej skorzystać więcej niż raz. - Okres dostępności oferty: zasób
SubscriptionOfferzawiera teraz opcjonalne polastartTimeiendTime, które określają, kiedy oferta, np. oferta utrzymania, staje się dostępna i kiedy przestaje być dostępna. - Kierowanie na użytkownika: aby oferta na utrzymanie była dostępna tylko dla określonych subskrybentów, ustaw
retentionPerUserRule(RetentionPerUserTargetingRule) w polutargetingoferty. Aby kierować ofertę na subskrypcję, wywołaj metodępurchases.subscriptionsv2.activateOfferTargetingz parametramipurchaseTokeniofferId. Aby usunąć kierowanie, wywołaj metodępurchases.subscriptionsv2.deactivateOfferTargeting. Zasób SubscriptionPurchaseV2 zawiera listę ofert kierowanych na każdy element zamówienia w poludeveloperTargetedOffers, w tymofferIdiactivateTimekażdej oferty. - Powiadomienia o zmianie abonamentu: nowy typ powiadomienia RTDN dotyczącego subskrypcji,
SUBSCRIPTION_PLAN_TRANSITION_UPDATED(21), jest wysyłany, gdy subskrybent zaakceptuje ofertę utrzymania. - Szczegóły przejścia na inny abonament: zasób SubscriptionPurchaseV2 zawiera teraz obiekt
planTransitionDetailswautoRenewingPlan. Identyfikuje zaakceptowaną ofertę utrzymania wofferIdi raportuje stan przejścia wtransitionInfo.
- Kierowanie na utrzymanie: aby utworzyć lub zaktualizować ofertę na utrzymanie za pomocą metody
Weryfikacja tagu ETag na potrzeby anulowania i unieważnienia subskrypcji: metody
purchases.subscriptionsv2.cancelipurchases.subscriptionsv2.revokeobsługują teraz opcjonalne poleetagwCancellationContextiRevocationContext. Użyj polaetag, aby zapobiec konfliktom, gdy wiele żądań modyfikuje tę samą subskrypcję w tym samym czasie. Pobierz wartośćetagz polaetagnajwyższego poziomu zwróconego przez ostatnie wywołaniepurchases.subscriptionsv2.get.
6 lipca 2026 r.
Nowe funkcje
Aktualizacje dotyczące odpowiedzialności za koszty obciążenia zwrotnego: Google Play obsługuje teraz proces zgłaszania sprzeciwu dotyczący obciążenia zwrotnego.
Powiadomienia o oczekujących na sprawdzenie zwrotach środków: nowy typ powiadomień w czasie rzeczywistym dla deweloperów (RTDN) –
PendingRefundReviewNotification– jest wysyłany, gdy użytkownik prosi o obciążenie zwrotne, które wymaga Twojej weryfikacji. W przypadku próśb oczekujących na sprawdzenie jako powód zwrotu środków można podać tylkoCHARGEBACK.ReviewRefund API: możesz ocenić te prośby i odpowiedzieć na nie w ciągu 24 godzin, wywołując nowy interfejs API
orders.reviewrefund. W wywołaniu interfejsu API musisz podać preferencje dotyczące zwrotu środków (np.APPROVE,DECLINElubNEUTRAL) oraz wszelkie istotne dowody korzystania z zakupu (np. adres IP użytkownika, skumulowany procent wykorzystania i przybliżone położenie geograficzne), aby pomóc Google Play zakwestionować obciążenie zwrotne.
19 maja 2026 r.
Nowe funkcje
- Identyfikator oczekującego zamówienia: interfejs API SubscriptionPurchaseV2 zawiera teraz pola
onHoldStateContextiinGracePeriodStateContext. Te pola zawierają dodatkowe informacje, takie jak identyfikator oczekującego lub nieudanego zamówienia, gdy subskrypcja przechodzi w stanON_HOLDlubIN_GRACE_PERIODz powodu odrzucenia płatności za odnowienie.
Elementy wycofane
- Niektóre interfejsy API subskrypcji zostały wycofane. Więcej informacji znajdziesz w artykule Wycofanie interfejsu Subscription API w maju 2026 r.
27 stycznia 2026 r.
Nowe funkcje
Subskrypcja z odroczeniem dodatków: wcześniej interfejs Google Play Developer API umożliwiał odroczenie płatności tylko w przypadku pojedynczych subskrypcji. Funkcja odroczenia jest już dostępna zarówno w przypadku pojedynczych subskrypcji, jak i subskrypcji z dodatkami, za pomocą metody
purchases.subscriptionsv2.defer. Gdy odroczysz datę rozliczenia subskrypcji z dodatkami, data rozliczenia wszystkich elementów subskrypcji zostanie odroczona o określony czas.OfferPhase: pole
OfferPhasejest teraz dostępne w interfejsie API SubscriptionPurchaseV2. To pole zawiera informacje o bieżącym etapie oferty subskrypcji, który może być okresem proporcjonalnym, bezpłatnym okresem próbnym, ceną dla nowych użytkowników lub ceną abonamentu podstawowego.
19 listopada 2025 r.
Nowe funkcje
Ulepszona obsługa ponownej subskrypcji.
- Pole
outOfAppPurchaseContextjest już dostępne w SubscriptionPurchaseV2, co pomaga powiązać zakupy ponownej subskrypcji dokonane w Sklepie Play, podając szczegóły wygasłej subskrypcji. - Metoda purchases.subscriptions.acknowledge akceptuje teraz opcjonalny parametr
externalAccountIdw treści żądania, który umożliwia powiązanie zakupu ponownej subskrypcji z identyfikatorami użytkowników.
- Pole
Pole
SubscriptionPurchaseLineItem.itemReplacementjest już dostępne w SubscriptionPurchaseV2 i zawiera szczegółowe informacje o zastępowanym produkcie (jeśli dotyczy).Interfejs Orders API zawiera teraz pole
offerPhaseDetails, które dostarcza bardziej szczegółowych informacji o zamówieniach finansujących okres proporcjonalny.
11 września 2025 r.
Nowe funkcje
Interfejs API SubscriptionPurchaseV2 udostępnia teraz metodę
cancel.Ta metoda ulepsza dotychczasową funkcję purchases.subscriptions.cancel, wprowadzając obsługę parametru
cancellationTypew bibliotekach klienta.Funkcje zgody na podwyżkę ceny są dostępne:
Do zasobu SubscriptionPurchaseV2 dodano nowe pole:
SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.Dostępny jest nowy typ powiadomienia w czasie rzeczywistym dla deweloperów: SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.
30 czerwca 2025 r.
Nowe funkcje
- Dostępny jest nowy interfejs API ProductPurchaseV2, który obsługuje wiele opcji zakupu i ofert w przypadku produktów kupowanych raz.
21 maja 2025 r.
Elementy wycofane
- Niektóre interfejsy API subskrypcji zostały wycofane. Więcej informacji znajdziesz w artykule o wycofaniu interfejsu Subscription API.
Nowe funkcje
W zasobie SubscriptionPurchaseV2 są dostępne te nowe pola:
SubscriptionPurchaseLineItem.latest_successful_order_idPriceChangeState.CANCELED
Metoda
subscriptionsv2.revokeudostępnia teraz opcjęitem_based_refund.Interfejs API Orders udostępnia teraz metody
getibatchGet.
Inne zmiany
- Parametr subscriptionId jest opcjonalny w interfejsach API purchases.subscriptions.