REST Resource: purchases.subscriptionsv2

{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}

string

این نوع یک شیء SubscriptionPurchaseV2 را در سرویس androidpublisher نشان می دهد.

string

کد کشور/منطقه صورت‌حساب ISO 3166-1 آلفا-2 کاربر در زمان اعطای اشتراک.

object ( SubscriptionPurchaseLineItem )

اطلاعات سطح مورد برای خرید اشتراک. موارد موجود در همان خرید باید همه با AutoRenewingPlan یا همه با PrepaidPlan باشند.

string ( Timestamp format)

زمانی که در آن اشتراک اعطا شد. برای اشتراک های معلق تنظیم نشده است (اشتراک ایجاد شد اما در انتظار پرداخت در حین ثبت نام).

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

enum ( SubscriptionState )

وضعیت فعلی اشتراک.

string

شناسه سفارش آخرین سفارش مرتبط با خرید اشتراک. برای اشتراک تمدید خودکار، اگر هنوز تمدید نشده باشد، این شناسه سفارش سفارش ثبت نام است یا آخرین شناسه سفارش تکرارشونده (موفقیت، سفارش در انتظار یا رد شده). برای اشتراک پیش پرداخت، این شناسه سفارش مرتبط با رمز خرید درخواست شده است.

string

نشانه خرید اشتراک قدیمی در صورتی که این اشتراک یکی از موارد زیر باشد: * ثبت نام مجدد اشتراک لغو شده اما بدون پایان * ارتقا/کاهش از اشتراک قبلی. * تبدیل اشتراک از پیش پرداخت به تمدید خودکار. * تبدیل از اشتراک تمدید خودکار به پیش پرداخت. * اشتراک پیش پرداخت را تکمیل کنید.

object ( PausedStateContext )

زمینه اضافی در مورد اشتراک های متوقف شده. فقط در صورتی ارائه می شود که اشتراک در حال حاضر دارای حالت اشتراک SUBSCRIPTION_STATE_PAUSED باشد.

object ( CanceledStateContext )

زمینه اضافی در مورد اشتراک های لغو شده. فقط در صورتی ارائه می شود که اشتراک در حال حاضر دارای اشتراک ایالت SUBSCRIPTION_STATE_CANCELED یا SUBSCRIPTION_STATE_EXPIRED باشد.

object ( TestPurchase )

فقط در صورتی ارائه شود که این خرید اشتراک یک خرید آزمایشی باشد.

enum ( AcknowledgementState )

وضعیت تأیید اشتراک.

object ( ExternalAccountIdentifiers )

شناسه حساب کاربری در سرویس شخص ثالث.

object ( SubscribeWithGoogleInfo )

نمایه کاربر مرتبط با خریدهای انجام شده با «اشتراک با Google».

{
  "autoResumeTime": string
}

string ( Timestamp format)

زمانی که در آن اشتراک به طور خودکار از سر گرفته می شود.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}

object ( UserInitiatedCancellation )

اشتراک توسط کاربر لغو شد.

object ( SystemInitiatedCancellation )

اشتراک توسط سیستم لغو شد، برای مثال به دلیل مشکل صورت‌حساب.

object ( DeveloperInitiatedCancellation )

اشتراک توسط توسعه دهنده لغو شد.

object ( ReplacementCancellation )

اشتراک با یک اشتراک جدید جایگزین شد.

{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}

object ( CancelSurveyResult )

اطلاعات ارائه شده توسط کاربر هنگام تکمیل جریان لغو اشتراک (نظرسنجی دلیل لغو).

string ( Timestamp format)

زمانی که در آن اشتراک توسط کاربر لغو شد. ممکن است کاربر پس از این مدت همچنان به اشتراک دسترسی داشته باشد. از lineItems.expiry_time برای تعیین اینکه آیا کاربر همچنان دسترسی دارد یا خیر استفاده کنید.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}

enum ( CancelSurveyReason )

دلیل انتخاب کاربر در نظرسنجی لغو.

string

فقط برای CANCEL_SURVEY_REASON_OTHERS تنظیم شده است. این پاسخ فرم آزاد کاربر به نظرسنجی است.

{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

شناسه حساب کاربری در سرویس شخص ثالث. فقط در صورتی ارائه شود که پیوند حساب به عنوان بخشی از جریان خرید اشتراک اتفاق افتاده باشد.

string

یک نسخه مبهم از شناسه که به طور منحصر به فرد با حساب کاربر در برنامه شما مرتبط است. برای خریدهای زیر ارائه دهید: * اگر پیوند حساب به عنوان بخشی از جریان خرید اشتراک اتفاق افتاده باشد. * هنگام خرید با استفاده از https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid مشخص شد.

string

یک نسخه مبهم از شناسه که به طور منحصر به فرد با نمایه کاربر در برنامه شما مرتبط است. فقط در صورت مشخص شدن با استفاده از https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid هنگام خرید.

{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}

string

شناسه نمایه Google کاربر هنگام خرید اشتراک.

string

نام نمایه کاربر هنگام خرید اشتراک.

string

آدرس ایمیل کاربر هنگام خرید اشتراک.

string

نام داده شده کاربر هنگام خرید اشتراک.

string

نام خانوادگی کاربر هنگام خرید اشتراک.

{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}

string

شناسه محصول خریداری شده (به عنوان مثال، 'monthly001').

string ( Timestamp format)

زمانی که در آن اشتراک منقضی می‌شود یا منقضی می‌شود مگر اینکه دسترسی تمدید شود (مثلاً تمدید شود).

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

object ( AutoRenewingPlan )

مورد در حال تمدید خودکار است.

object ( PrepaidPlan )

کالا پیش پرداخت شده است.

object ( OfferDetails )

جزئیات پیشنهاد برای این مورد.

object ( DeferredItemReplacement )

اطلاعات مربوط به تعویض کالای معوق

{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  }
}

boolean

اگر اشتراک در حال حاضر روی تمدید خودکار تنظیم شده باشد، به عنوان مثال کاربر اشتراک را لغو نکرده است

object ( SubscriptionItemPriceChangeDetails )

اطلاعات آخرین تغییر قیمت کالا از زمان ثبت نام.

object ( InstallmentPlan )

تعهد طرح اقساطی و اطلاعات مربوط به طرح تمدید خودرو.

{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}

object ( Money )

قیمت تکراری جدید برای مورد اشتراک.

enum ( PriceChangeMode )

حالت تغییر قیمت نحوه تغییر قیمت آیتم اشتراک را مشخص می کند.

enum ( PriceChangeState )

اعلام کنید تغییر قیمت در حال حاضر انجام شده است.

string ( Timestamp format)

زمان تمدید که در آن تغییر قیمت برای کاربر موثر خواهد بود. به دلیل مواردی که زمان تمدید مانند مکث تغییر می کند، ممکن است (به زمان آینده) تغییر کند. این قسمت فقط در صورتی پر می شود که تغییر قیمت اعمال نشده باشد.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}

integer

تعداد کل پرداخت هایی که کاربر در ابتدا متعهد شده است.

integer

تعداد کل پرداخت هایی که کاربر پس از هر دوره تعهد متعهد می شود. خالی به این معنی است که طرح اقساط پس از تعهد اولیه به اشتراک عادی تمدید خودکار بازمی گردد.

integer

تعداد کل پرداخت‌های متعهد باقی مانده برای پرداخت در این چرخه تمدید.

object ( PendingCancellation )

در صورت وجود، این طرح اقساطی در انتظار لغو است. لغو تنها پس از پایان تمام پرداخت های متعهد توسط کاربر انجام می شود.

{
  "allowExtendAfterTime": string
}

string ( Timestamp format)

در صورت وجود، این زمانی است که پس از آن خریدهای شارژ برای طرح پیش پرداخت مجاز است. برای طرح های پیش پرداخت منقضی شده حضور نخواهد داشت.

یک مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}

string

آخرین برچسب های پیشنهاد مرتبط با پیشنهاد. این شامل تگ های به ارث رسیده از طرح پایه است.

string

شناسه طرح پایه ارائه برای همه طرح های پایه و پیشنهادات.

string

شناسه پیشنهاد فقط برای پیشنهادات با تخفیف ارائه می شود.

{
  "productId": string
}

string

productId جایگزین productId موجود می شود.