Informacje o wersji interfejsu Google Play Developer API

Ten dokument zawiera informacje o wersji interfejsów Google Play Developer API.

6 lipca 2026 r.

Nowe funkcje

• Aktualizacje dotyczące odpowiedzialności za koszty obciążenia zwrotnego: Google Play obsługuje teraz proces rozpatrywania obciążeń zwrotnych we współpracy z deweloperem.

  • Powiadomienia o oczekujących na sprawdzenie zwrotach środków: gdy użytkownik poprosi o obciążenie zwrotne, które wymaga Twojej weryfikacji, wysyłamy nowe powiadomienie w czasie rzeczywistym dla deweloperów o typie PendingRefundReviewNotification. W przypadku oczekujących na sprawdzenie zwrotów środków obsługiwany jest tylko powód zwrotu CHARGEBACK.

  • Interfejs ReviewRefund API: możesz ocenić te prośby i odpowiedzieć na nie w ciągu 24 godzin, wywołując nowy orders.reviewrefund API. W wywołaniu interfejsu API musisz podać preferencje dotyczące zwrotu środków (np. APPROVE, DECLINE lub NEUTRAL) oraz wszelkie istotne dowody użycia zakupu (np. adres IP użytkownika, łączny odsetek wykorzystania i przybliżoną lokalizację geograficzną), aby pomóc Google Play w rozpatrzeniu obciążenia zwrotnego.

19 maja 2026 r.

Nowe funkcje

• Identyfikator zamówienia w stanie oczekiwania: interfejs SubscriptionPurchaseV2 API zawiera teraz pola onHoldStateContext i inGracePeriodStateContext. Te pola zawierają dodatkowe informacje, takie jak identyfikator zamówienia w stanie oczekiwania lub nieudanego zamówienia, gdy subskrypcja przechodzi w stan ON_HOLD lub IN_GRACE_PERIOD z 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

• Odroczenie subskrypcji z dodatkami: wcześniej interfejs Google Play Developer API umożliwiał odroczenie płatności tylko w przypadku pojedynczych subskrypcji. Funkcja odroczenia jest teraz dostępna zarówno w przypadku pojedynczych subskrypcji, jak i subskrypcji z dodatkami za pomocą purchases.subscriptionsv2.defer metody. Gdy odroczysz datę płatności za subskrypcję z dodatkami, data płatności za wszystkie elementy w subskrypcji zostanie odroczona o określony czas.

• OfferPhase: pole OfferPhase jest teraz dostępne w interfejsie SubscriptionPurchaseV2 API. To pole zawiera aktualną fazę oferty subskrypcji jako okres proporcjonalny, bezpłatny okres próbny, cenę początkową lub cenę abonamentu podstawowego.

19 listopada 2025 r.

Nowe funkcje

• Ulepszona obsługa ponownej subskrypcji.

  • W interfejsie outOfAppPurchaseContext API jest teraz dostępne pole SubscriptionPurchaseV2, które pomaga powiązać zakupy ponownej subskrypcji dokonane w Sklepie Play, podając szczegóły wygasłej subskrypcji.
  • Metoda purchases.subscriptions.acknowledge akceptuje teraz opcjonalny externalAccountId w treści żądania, co pozwala powiązać zakup ponownej subskrypcji z identyfikatorami użytkowników.

• Pole SubscriptionPurchaseLineItem.itemReplacement jest teraz dostępne w SubscriptionPurchaseV2, które zawiera szczegóły dotyczące zastępowanego elementu (jeśli dotyczy).

• Interfejs Orders API zawiera teraz pole offerPhaseDetails, które zawiera bardziej szczegółowe informacje o zamówieniach finansujących okres proporcjonalny.

11 września 2025 r.

Nowe funkcje

• Interfejs SubscriptionPurchaseV2 API udostępnia teraz metodę cancel.

  Ta metoda ulepsza dotychczasową funkcję purchases.subscriptions.cancel, wprowadzając obsługę parametru cancellationType w bibliotekach klienta.

• Dostępne są funkcje zgody na podwyższenie ceny:

  • W interfejsie SubscriptionPurchaseV2 API dodaliśmy 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 ProductPurchaseV2 API, który obsługuje wiele opcji zakupu i ofert produktów kupowanych raz.

21 maja 2025 r.

Elementy wycofane

• Niektóre interfejsy API subskrypcji zostały wycofane. Więcej informacji znajdziesz w artykule Wycofanie interfejsu Subscription API.

Nowe funkcje

• W interfejsie SubscriptionPurchaseV2 API dostępne są te nowe pola:

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• Metoda subscriptionsv2.revoke udostępnia teraz opcję item_based_refund.

• Interfejs Orders API udostępnia teraz metody get i batchGet.

Inne zmiany

• Parametr subscriptionId jest opcjonalny w interfejsach purchases.subscriptions API.