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

این سند حاوی یادداشت‌های انتشار برای Google Play Developer APIs است.

‫۶ ژوئیه ۲۰۲۶

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

  • به‌روزرسانی‌های مسئولیت هزینه استرداد مبلغ: Google Play اکنون از فرایند حل اختلاف استرداد مبلغ مشارکتی پشتیبانی می‌کند.

    • اعلان‌های بررسی استرداد مبلغ معلقه: نوع جدیدی از اعلان بی‌درنگ توسعه‌دهنده (RTDN)، PendingRefundReviewNotification، زمانی ارسال می‌شود که کاربر درخواست استرداد وجهی را می‌دهد که نیاز به بررسی شما دارد. بازبینی‌های معلقه فقط از CHARGEBACK به‌عنوان دلیل استرداد مبلغ پشتیبانی می‌کنند.

    • ReviewRefund API: می‌توانید این درخواست‌ها را ارزیابی کنید و ظرف ۲۴ ساعت با فراخوانی orders.reviewrefund API جدید پاسخ دهید. در فراخوانی API، باید اولویت بازپرداخت (مانند APPROVE، DECLINE، یا NEUTRAL) و هرگونه شواهد مربوط به استفاده از خرید (مانند نشانی IP کاربر، درصد مصرف تجمعی، و مکان جغرافیایی تقریبی) را ارائه دهید تا به Google Play کمک کنید با بازپرداخت وجه مخالفت کند.

۱۹ مه ۲۰۲۶

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

  • شناسه سفارش معلقه: میانای برنامه‌سازی کاربردی SubscriptionPurchaseV2 اکنون شامل فیلدهای onHoldStateContext و inGracePeriodStateContext است. این فیلدها جزئیات بیشتری ارائه می‌دهند، مثل شناسه سفارش معلقه یا ناموفق، وقتی که اشتراک به‌دلیل رد شدن پرداخت تمدید وارد وضعیت ON_HOLD یا IN_GRACE_PERIOD می‌شود.

منسوخ‌شدن‌ها

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

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

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

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

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

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

  • مدیریت بهبودیافته «ازسرگرفتن اشتراک».

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

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

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

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

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

‫۳۰ ژوئن ۲۰۲۵

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

‫۲۱ مه ۲۰۲۵

منسوخ‌شدن‌ها

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

  • فیلدهای جدید زیر در SubscriptionPurchaseV2 دردسترس است:

    • SubscriptionPurchaseLineItem.latest_successful_order_id
    • PriceChangeState.CANCELED

  • روش subscriptionsv2.revoke اکنون گزینه item_based_refund را ارائه می‌دهد.

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

تغییرات دیگر

  • پارامتر subscriptionId در میاناهای برنامه‌سازی کاربردی purchases.subscriptions اختیاری است.