این سند، APIهای توسعهدهندگان گوگل پلی و ویژگیهای مرتبط با آنها را که در دورهی منسوخ شدن هستند، فهرست میکند.
جدول زمانی منسوخ شدن - ۱۹ مه ۲۰۲۶ تا ۳۱ آگوست ۲۰۲۸
ویژگیها و APIهای این بخش از تاریخ ۱۹ مه ۲۰۲۶ منسوخ شدهاند و در ۳۱ آگوست ۲۰۲۸ نیز غیرفعال خواهند شد. با این حال، میتوانید برای موارد منسوخشده تا ۱ نوامبر ۲۰۲۸ تمدید اعتبار کنید.
APIهای اشتراک منسوخشده
این بخش، منسوخشدههای API را فهرست میکند.
جدول زمانی استهلاک - ۲۱ مه ۲۰۲۵ تا ۳۱ آگوست ۲۰۲۷
ویژگیها و APIهای این بخش از ۲۱ مه ۲۰۲۵ منسوخ شدهاند و در ۳۱ آگوست ۲۰۲۷ نیز غیرفعال خواهند شد. با این حال، میتوانید برای موارد منسوخشده تا ۱ نوامبر ۲۰۲۷ تمدید اعتبار کنید.
APIهای اشتراک منسوخشده
این بخش، منسوخشدههای API را فهرست میکند.
| رابط برنامهنویسی کاربردی | جایگزین موجود |
|---|---|
| اشتراکها.دریافت | subscriptionsv2.get |
| بازپرداخت حق اشتراک | برای دریافت SubscriptionPurchaseLineItem.latest_successful_order_id، subscriptionsv2.get را فراخوانی کنید و سپس برای بازپرداخت سفارشات ، Orders.refund را فراخوانی کنید. |
| لغو اشتراکها | لغو اشتراک نسخه ۲ |
| شناسه آخرین سفارش (SubscriptionPurchaseV2. latestOrderId) | خط خرید اشتراک. شناسه آخرین سفارش موفق |
| RealTimeDeveloperNotification.SubscriptionNotification.subscriptionId | بدون جایگزینی |
| اعلان توسعهدهندهی زمان واقعی. اعلان اشتراک. نوع اعلان SUBSCRIPTION_PRICE_CHANGE_CONFIRMED | قیمت اشتراک _تغییرات_بهروزرسانی شد |
فیلدهای SubscriptionPurchaseV2 برای اشتراکهای دورهای
purchases.subscriptionv2 شامل فیلدهای جدیدی است که جزئیات بیشتری در مورد اشیاء اشتراک جدید ارائه میدهند. جدول زیر نشان میدهد که چگونه فیلدها از نقطه پایانی اشتراک قدیمی به فیلدهای مربوطه در purchases.subscriptionv2 نگاشت میشوند.
| اشتراکخرید | اشتراکخرید نسخه ۲ |
|---|---|
countryCode | regionCode |
orderId | lineItems.latestSuccessfulOrderIdمیتوانید شناسه سفارش در حال انتظار را از inGracePeriodStateContext.renewalDeclined.pendingOrderId یا onHoldStateContext.renewalDeclined.pendingOrderId دریافت کنید. |
startTimeMillis | startTime |
expiryTimeMillis | lineItems.expiryTime (هر اشتراکی که در خرید به دست میآید، expiryTime مخصوص به خود را دارد) |
autoResumeTimeMillis | pausedStateContext.autoResumeTime |
autoRenewing | lineItems.autoRenewingPlan.autoRenewEnabled |
priceCurrenceCode ، priceAmountMicros | lineItems.autoRenewingPlan.recurringPrice |
introductoryPriceInfo | lineItems.offerPhase.introductoryPriceاین اطلاعات همچنین در offer مربوط به هر یک از اشتراکهای خریداری شده قابل مشاهده است. |
developerPayload | (فیلد معادلی وجود ندارد) payload توسعهدهنده منسوخ شده است |
paymentState | (فیلد معادل ندارد) شما میتوانید وضعیت پرداخت را از subscriptionState استنباط کنید:
|
cancelReason ، userCancellationTimeMillis ، cancelSurveyResult | canceledStateContext |
linkedPurchaseToken | linkedPurchaseToken (بدون تغییر) |
purchaseType | تست: از طریق testPurchaseتبلیغات: signupPromotion |
priceChange | lineItems.autoRenewingPlan.priceChangeDetails |
profileName ، emailAddress ، givenName ، familyName ، profileId | subscribeWithGoogleInfo |
acknowledgementState | acknowledgementState (no change) |
promotionType ، promotionCode | signupPromotion |
externalAccountId ، obfuscatedExternalAccountId خارجی، obfuscatedExteranlProfileId | externalAccountIdentifiers |