این سند، 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 | SubscriptionPurchaseLineItem.latest_successful_order_id |
| (فیلد معادل ندارد) | lineItems.offerPhase (مرحله فعلی را مشخص میکند: دوره آزمایشی رایگان، قیمت مقدماتی، نسبت قیمت به قیمت، قیمت پایه) |
| (فیلد معادل ندارد) | lineItems (لیست SubscriptionPurchaseLineItem) که نشان دهنده محصولات خریداری شده با خرید است |
| (فیلد معادل ندارد) | lineItems.offerDetails.basePlanId |
| (فیلد معادل ندارد) | lineItems.offerDetails.offerId |
| (فیلد معادل ندارد) | lineItems.offerDetails.offerTags |
startTimeMillis | startTime |
expiryTimeMillis | lineItems.expiryTime (هر اشتراکی که در خرید به دست میآید، expiryTime مخصوص به خود را دارد) |
| (فیلد معادل ندارد) | subscriptionState (وضعیت اشتراک را نشان میدهد) |
| (فیلد معادل ندارد) | pausedStateContext (فقط در صورتی وجود دارد که وضعیت اشتراک SUBSCRIPTION_STATE_PAUSED باشد) |
autoResumeTimeMillis | pausedStateContext.autoResumeTime |
| (فیلد معادل ندارد) | canceledStateContext (فقط در صورتی وجود دارد که وضعیت اشتراک SUBSCRIPTION_STATE_CANCELED باشد) |
| (فیلد معادل ندارد) | testPurchase (فقط در خریدهای تستر دارای مجوز موجود است) |
autoRenewing | lineItems.autoRenewingPlan.autoRenewEnabled |
priceCurrenceCode ، priceAmountMicros | lineItems.autoRenewingPlan.recurringPrice |
introductoryPriceInfo | lineItems.offerPhase.introductoryPriceاین اطلاعات همچنین در offer مربوط به هر یک از اشتراکهای خریداری شده قابل مشاهده است. |
| developerPayload | (فیلد معادلی وجود ندارد) payload توسعهدهنده منسوخ شده است |
| پرداخت ایالتی | (فیلد معادل ندارد) شما میتوانید وضعیت پرداخت را از 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 |
سایر عملکردهای مدیریت اشتراک
در حالی که purchases.subscriptions:get به purchases.subscriptionsv2:get ارتقا یافته است، بقیه توابع مدیریت اشتراک توسعهدهندگان فعلاً در نقطه پایانی purchases.subscriptions بدون تغییر باقی میمانند، بنابراین میتوانید مانند قبل به استفاده از purchases.subscriptions:acknowledge ، purchases.subscriptions:cancel ، purchases.subscriptions:defer ، purchases.subscriptions:refund و purchases.subscriptions:revoke ادامه دهید.