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

Loại này đại diện cho đối tượng SubscriptionPurchaseV2 trong dịch vụ androidpublisher.

string

Mã quốc gia/khu vực thanh toán theo ISO 3166-1 alpha-2 của người dùng tại thời điểm cấp gói thuê bao.

object (SubscriptionPurchaseLineItem)

Thông tin ở cấp mặt hàng cho giao dịch mua gói thuê bao. Các mặt hàng trong cùng một giao dịch mua phải đều có AutoRenewingPlan hoặc đều có PrepaidPlan.

string (Timestamp format)

Thời điểm cấp gói thuê bao. Chưa được đặt cho các gói thuê bao đang chờ xử lý (gói thuê bao đã được tạo nhưng đang chờ thanh toán trong quá trình đăng ký).

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

enum (SubscriptionState)

Trạng thái hiện tại của gói thuê bao.

string

Mã đơn đặt hàng của đơn đặt hàng mới nhất được liên kết với giao dịch mua gói thuê bao. Đối với gói thuê bao tự động gia hạn, đây là mã đơn đặt hàng của đơn đăng ký nếu đơn đặt hàng đó chưa được gia hạn hoặc mã đơn đặt hàng định kỳ gần đây nhất (đơn đặt hàng thành công, đang chờ xử lý hoặc bị từ chối). Đối với gói thuê bao trả trước, đây là mã đơn hàng được liên kết với mã thông báo giao dịch mua được truy vấn.

string

Mã thông báo giao dịch mua của gói thuê bao cũ nếu gói thuê bao này thuộc một trong những trường hợp sau: * Đăng ký lại gói thuê bao đã huỷ nhưng chưa hết hạn * Nâng cấp/hạ cấp từ một gói thuê bao trước đó. * Chuyển đổi từ gói thuê bao trả trước sang gói thuê bao tự động gia hạn. * Chuyển đổi từ gói thuê bao tự động gia hạn sang gói trả trước. * Nạp tiền cho gói thuê bao trả trước.

object (PausedStateContext)

Thông tin bổ sung về các gói thuê bao đang tạm dừng. Chỉ xuất hiện nếu gói thuê bao hiện có subscriptionState SUBSCRIPTION_STATE_PAUSED.

object (CanceledStateContext)

Thông tin bổ sung về các gói thuê bao đã huỷ. Chỉ xuất hiện nếu gói thuê bao hiện có subscriptionState SUBSCRIPTION_STATE_CANCELED hoặc SUBSCRIPTION_STATE_EXPIRED.

object (TestPurchase)

Chỉ xuất hiện nếu giao dịch mua gói thuê bao này là giao dịch mua thử.

enum (AcknowledgementState)

Trạng thái xác nhận của gói thuê bao.

object (ExternalAccountIdentifiers)

Giá trị nhận dạng tài khoản người dùng trong dịch vụ bên thứ ba.

object (SubscribeWithGoogleInfo)

Hồ sơ người dùng được liên kết với các giao dịch mua được thực hiện bằng tính năng "Đăng ký bằng Google".

{
  "autoResumeTime": string
}

string (Timestamp format)

Thời điểm gói thuê bao sẽ tự động tiếp tục.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "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)

Người dùng đã huỷ gói thuê bao.

object (SystemInitiatedCancellation)

Hệ thống đã huỷ gói thuê bao, ví dụ: do vấn đề thanh toán.

object (DeveloperInitiatedCancellation)

Nhà phát triển đã huỷ gói thuê bao.

object (ReplacementCancellation)

Gói thuê bao đã được thay thế bằng một gói thuê bao mới.

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

object (CancelSurveyResult)

Thông tin do người dùng cung cấp khi họ hoàn tất quy trình huỷ gói thuê bao (bản khảo sát về lý do huỷ).

string (Timestamp format)

Thời điểm người dùng huỷ gói thuê bao. Người dùng có thể vẫn có quyền truy cập vào gói thuê bao sau thời điểm này. Sử dụng lineItems.expiry_time để xác định xem người dùng có còn quyền truy cập hay không.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

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

enum (CancelSurveyReason)

Lý do mà người dùng đã chọn trong bản khảo sát về lý do huỷ.

string

Chỉ đặt cho CANCEL_SURVEY_REASON_OTHERS. Đây là câu trả lời dạng tự do của người dùng cho cuộc khảo sát.

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

string

Giá trị nhận dạng tài khoản người dùng trong dịch vụ bên thứ ba. Chỉ xuất hiện nếu quá trình liên kết tài khoản diễn ra trong quy trình mua gói thuê bao.

string

Phiên bản mã nhận dạng bị làm rối được liên kết duy nhất với tài khoản của người dùng trong ứng dụng. Xuất hiện trong các giao dịch mua sau: * Nếu quá trình liên kết tài khoản diễn ra trong quy trình mua gói thuê bao. * Mã này được chỉ định bằng https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid khi giao dịch mua được thực hiện.

string

Phiên bản mã nhận dạng đã làm rối mã nguồn được liên kết riêng biệt với hồ sơ của người dùng trong ứng dụng. Chỉ xuất hiện nếu được chỉ định bằng https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid khi giao dịch mua được thực hiện.

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

string

Mã hồ sơ Google của người dùng khi họ mua gói thuê bao.

string

Tên hồ sơ của người dùng khi mua gói thuê bao.

string

Địa chỉ email của người dùng khi người dùng mua gói thuê bao.

string

Tên của người dùng khi mua gói thuê bao.

string

Họ của người dùng khi mua gói thuê bao.

{
  "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.
  "signupPromotion": {
    object (SignupPromotion)
  }
}

string

Mã sản phẩm được mua (ví dụ: "monthly001").

string (Timestamp format)

Thời điểm gói thuê bao hết hạn hoặc sẽ hết hạn trừ phi quyền truy cập được gia hạn (ví dụ: gia hạn).

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

object (AutoRenewingPlan)

Mục này đang tự động gia hạn.

object (PrepaidPlan)

Mặt hàng được thanh toán trước.

object (OfferDetails)

Thông tin chi tiết về ưu đãi cho mặt hàng này.

object (DeferredItemReplacement)

Thông tin về việc thay thế mặt hàng bị trì hoãn.

object (SignupPromotion)

Thông tin chi tiết về chương trình khuyến mãi của mặt hàng này. Chỉ được đặt nếu người dùng đã áp dụng chương trình khuyến mãi trong quá trình đăng ký.

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

boolean

Nếu gói thuê bao hiện đang được đặt thành tự động gia hạn, ví dụ: người dùng chưa huỷ gói thuê bao

object (SubscriptionItemPriceChangeDetails)

Thông tin về lần thay đổi giá gần đây nhất của mặt hàng kể từ khi người dùng đăng ký gói thuê bao.

object (InstallmentPlan)

Cam kết về gói trả góp và thông tin liên quan đến trạng thái của gói tự động gia hạn.

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

object (Money)

Giá định kỳ mới cho mặt hàng thuê bao.

enum (PriceChangeMode)

Chế độ thay đổi giá chỉ định cách giá của mặt hàng trong gói thuê bao thay đổi.

enum (PriceChangeState)

Trạng thái của việc thay đổi giá.

string (Timestamp format)

Thời điểm gia hạn mà thay đổi về giá sẽ có hiệu lực đối với người dùng. Thời gian này có thể thay đổi(thành một thời điểm trong tương lai) do các trường hợp thời gian gia hạn thay đổi như tạm dừng. Trường này chỉ được điền nếu thay đổi về giá chưa có hiệu lực.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

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

integer

Tổng số khoản thanh toán mà người dùng cam kết ban đầu.

integer

Tổng số khoản thanh toán mà người dùng sẽ cam kết sau mỗi khoảng thời gian cam kết. Trống có nghĩa là gói trả góp sẽ chuyển về gói thuê bao tự động gia hạn thông thường sau khi hết thời hạn cam kết ban đầu.

integer

Tổng số khoản thanh toán đã cam kết còn phải thanh toán trong chu kỳ gia hạn này.

object (PendingCancellation)

Nếu có, gói trả góp này đang chờ huỷ. Việc huỷ chỉ diễn ra sau khi người dùng hoàn tất tất cả các khoản thanh toán đã cam kết.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Nếu có, đây là thời điểm sau đó người dùng có thể mua gói nạp tiền cho gói trả trước. Sẽ không xuất hiện đối với các gói trả trước đã hết hạn.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

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

string

Thẻ mặt hàng mới nhất được liên kết với mặt hàng. Gói này bao gồm các thẻ được kế thừa từ gói cơ bản.

string

Mã gói cơ bản. Có trong tất cả các gói cơ bản và ưu đãi.

string

Mã ưu đãi. Chỉ xuất hiện đối với các mặt hàng giảm giá.

{
  "productId": string
}

string

productId sẽ thay thế productId hiện có.

{

  // Union field promotion_type can be only one of the following:
  "oneTimeCode": {
    object (OneTimeCode)
  },
  "vanityCode": {
    object (VanityCode)
  }
  // End of list of possible types for union field promotion_type.
}

object (OneTimeCode)

Mã một lần đã được áp dụng.

object (VanityCode)

Bạn đã áp dụng mã nhận dạng.

{
  "promotionCode": string
}

string

Mã khuyến mãi.