یادداشت‌های انتشار Google Play Developer API

این سند حاوی یادداشت‌های انتشار برای APIهای توسعه‌دهندگان گوگل پلی است.

۲۷ ژانویه ۲۰۲۶

ویژگی‌های جدید

• اشتراک با افزونه‌ها به تعویق می‌افتد: پیش از این، API توسعه‌دهندگان گوگل پلی، تعویق پرداخت صورتحساب را فقط برای اشتراک‌های تکی مجاز می‌دانست. اکنون قابلیت تعویق برای اشتراک‌های تکی و اشتراک‌های دارای افزونه از طریق متد purchases.subscriptionsv2.defer در دسترس است. وقتی تاریخ صدور صورتحساب یک اشتراک با افزونه‌ها را به تعویق می‌اندازید، تاریخ صدور صورتحساب برای همه موارد موجود در اشتراک به مدت زمان مشخص شده به تعویق می‌افتد.

• مرحله پیشنهاد : فیلد OfferPhase اکنون در API خرید اشتراک V2 موجود است. این فیلد مرحله پیشنهاد فعلی اشتراک را به صورت یکی از دوره‌های سرشکن‌شده، دوره آزمایشی رایگان، قیمت مقدماتی و قیمت طرح پایه ارائه می‌دهد.

۱۹ نوامبر ۲۰۲۵

ویژگی‌های جدید

• مدیریت بهبود یافته‌ی اشتراک مجدد .

  • فیلد outOfAppPurchaseContext اکنون در SubscriptionPurchaseV2 موجود است، که با ارائه جزئیات اشتراک منقضی شده، به پیوند دادن خریدهای اشتراک مجدد انجام شده از فروشگاه Play کمک می‌کند.
  • متد purchases.subscriptions.acknowledge اکنون externalAccountId اختیاری را در بدنه درخواست می‌پذیرد، که به شما امکان می‌دهد خرید اشتراک مجدد را با شناسه‌های کاربری خود مرتبط کنید.

• فیلد SubscriptionPurchaseLineItem.itemReplacement اکنون در SubscriptionPurchaseV2 موجود است که در صورت لزوم، جزئیاتی در مورد کالای جایگزین شده ارائه می‌دهد.

• API سفارشات اکنون شامل فیلد offerPhaseDetails است که اطلاعات دقیق‌تری در مورد تأمین مالی سفارشات در یک دوره زمانی مشخص ارائه می‌دهد.

• در حال حاضر این ویژگی‌های جدید فقط از طریق APIها و نه از طریق کتابخانه‌های کلاینت در دسترس هستند.

۱۱ سپتامبر ۲۰۲۵

ویژگی‌های جدید

• 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 را ارائه می‌دهد.

• API سفارشات اکنون متدهای get و batchGet را ارائه می‌دهد.

تغییرات دیگر

• پارامتر subscriptionId در APIهای purchases.subscriptions اختیاری است.