این سند حاوی یادداشتهای انتشار برای APIهای توسعهدهندگان گوگل پلی است.
۶ ژوئیه ۲۰۲۶
ویژگیهای جدید
بهروزرسانیهای مربوط به مسئولیت هزینه بازگشت وجه : گوگل پلی اکنون از یک فرآیند حل اختلاف مشارکتی بازگشت وجه پشتیبانی میکند.
اعلانهای بررسی بازپرداخت در انتظار : یک نوع اعلان توسعهدهنده (RTDN) جدید در لحظه،
PendingRefundReviewNotification، زمانی ارسال میشود که کاربری درخواست بازپرداخت وجهی را میدهد که نیاز به بررسی شما دارد. بررسیهای در انتظار فقطCHARGEBACKبه عنوان دلیل بازپرداخت پشتیبانی میکنند.API مربوط به ReviewRefund : شما میتوانید این درخواستها را ارزیابی کرده و ظرف ۲۴ ساعت با فراخوانی API
orders.reviewrefundجدید.reviewrefund پاسخ دهید. در فراخوانی API، باید ترجیح بازپرداخت (مانندAPPROVE،DECLINEیاNEUTRAL) و هرگونه شواهد مربوط به استفاده از خرید (مانند آدرس IP کاربر، درصد مصرف تجمعی و موقعیت جغرافیایی تقریبی) را ارائه دهید تا به Google Play در رد درخواست بازپرداخت کمک کنید.
۱۹ مه ۲۰۲۶
ویژگیهای جدید
- شناسه سفارش در انتظار : رابط برنامهنویسی کاربردی SubscriptionPurchaseV2 اکنون شامل فیلدهای
onHoldStateContextوinGracePeriodStateContextاست. این فیلدها جزئیات بیشتری مانند شناسه سفارش در انتظار یا ناموفق را ارائه میدهند، زمانی که یک اشتراک به دلیل عدم پرداخت تمدید، وارد حالتON_HOLDیاIN_GRACE_PERIODمیشود.
منسوخشدهها
- برخی از APIهای اشتراک منسوخ شدهاند. برای اطلاعات بیشتر، به منسوخ شدن API اشتراک در ماه مه ۲۰۲۶ مراجعه کنید.
۲۷ ژانویه ۲۰۲۶
ویژگیهای جدید
Subscription with add-ons deferral : Previously, the Google Play Developer API allowed deferral of billing only for single subscriptions. The deferral functionality is now available for both single subscriptions and subscriptions with add-ons through the
purchases.subscriptionsv2.defermethod. When you defer the billing date of a subscription with add-ons, the billing date for all items in the subscription are deferred by the specified duration.مرحله پیشنهاد : فیلد
OfferPhaseاکنون در API خرید اشتراک V2 موجود است. این فیلد مرحله پیشنهاد فعلی اشتراک را به صورت یکی از دورههای سرشکنشده، دوره آزمایشی رایگان، قیمت مقدماتی و قیمت طرح پایه ارائه میدهد.
۱۹ نوامبر ۲۰۲۵
ویژگیهای جدید
مدیریت بهبود یافتهی اشتراک مجدد .
- فیلد
outOfAppPurchaseContextاکنون در SubscriptionPurchaseV2 موجود است، که با ارائه جزئیات اشتراک منقضی شده، به پیوند دادن خریدهای اشتراک مجدد انجام شده از فروشگاه Play کمک میکند. - متد purchases.subscriptions.acknowledge اکنون
externalAccountIdاختیاری را در بدنه درخواست میپذیرد، که به شما امکان میدهد خرید اشتراک مجدد را با شناسههای کاربری خود مرتبط کنید.
- فیلد
فیلد
SubscriptionPurchaseLineItem.itemReplacementاکنون در SubscriptionPurchaseV2 موجود است که در صورت لزوم، جزئیاتی در مورد کالای جایگزین شده ارائه میدهد.API سفارشات اکنون شامل فیلد
offerPhaseDetailsاست که اطلاعات دقیقتری در مورد تأمین مالی سفارشات در یک دوره زمانی مشخص ارائه میدهد.
۱۱ سپتامبر ۲۰۲۵
ویژگیهای جدید
API مربوط به SubscriptionPurchaseV2 اکنون متد
cancelرا ارائه میدهد.این روش با معرفی پشتیبانی از پارامتر
cancellationTypeدر کتابخانههای کلاینت، بهبودهایی نسبت به عملکرد موجود purchases.subscriptions.cancel ارائه میدهد.ویژگیهای رضایتنامه افزایش قیمت در دسترس هستند:
یک فیلد جدید در SubscriptionPurchaseV2 اضافه شده است:
SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.یک نوع اعلان توسعهدهندهی جدید و بلادرنگ با نام SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED در دسترس قرار گرفته است.
۳۰ ژوئن ۲۰۲۵
ویژگیهای جدید
- رابط برنامهنویسی کاربردی جدید ProductPurchaseV2 که از گزینههای خرید متعدد و پیشنهادهایی برای محصولات یکبارمصرف پشتیبانی میکند، در دسترس است.
۲۱ مه ۲۰۲۵
منسوخشدهها
- برخی از APIهای اشتراک منسوخ شدهاند. برای اطلاعات بیشتر، به بخش منسوخ شدن API اشتراک مراجعه کنید.
ویژگیهای جدید
فیلدهای جدید زیر در SubscriptionPurchaseV2 موجود هستند:
-
SubscriptionPurchaseLineItem.latest_successful_order_id -
PriceChangeState.CANCELED
-
متد
subscriptionsv2.revokeاکنون گزینهitem_based_refundرا ارائه میدهد.
تغییرات دیگر
- پارامتر subscriptionId در APIهای purchases.subscriptions اختیاری است.