REST Resource: purchases.subscriptionsv2

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tài nguyên: SubscriptionPurchaseV2

Cho biết trạng thái của giao dịch mua gói thuê bao của người dùng.

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "regionCode": string,
  "latestOrderId": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}
Các trường
kind

string

Loại này biểu thị đối tượng SubscriptionPurchaseV2 trong dịch vụ androidpublisher.

regionCode

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 đăng ký được cấp.

latestOrderId

string

Mã đơn hàng của đơn đặt hàng mới nhất 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 hàng của đơn đặt hàng đăng ký nếu mã này chưa được gia hạn hoặc mã đơn hàng định kỳ cuối cù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 liên kết với mã thông báo giao dịch được truy vấn.

lineItems[]

object (SubscriptionPurchaseLineItem)

Thông tin cấp mặt hàng của một 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 là tất cả các mặt hàng có tính năng AutorefreshingPlan hoặc tất cả đều có PREPlan.

startTime

string (Timestamp format)

Thời điểm cấp gói thuê bao. Chưa đặ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 RFC3339 UTC "Zulu" với độ phân giải nano giây và tối đa chín chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

subscriptionState

enum (SubscriptionState)

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

linkedPurchaseToken

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 là một trong những loại sau đây: * Đăng ký lại gói thuê bao đã huỷ nhưng không hết hạn * Nâng cấp/hạ cấp 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.

pausedStateContext

object (PausedStateContext)

Ngữ cảnh bổ sung về các gói thuê bao bị tạm dừng. Chỉ hiển thị nếu gói thuê bao hiện có subscriptionState SUBSCRIPTION_State_PAUSED.

canceledStateContext

object (CanceledStateContext)

Bối cảnh bổ sung về các gói thuê bao đã huỷ. Chỉ hiển thị nếu gói thuê bao hiện có subscriptionState SUBSCRIPTION_State_CANCELED.

testPurchase

object (TestPurchase)

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

acknowledgementState

enum (AcknowledgementState)

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

externalAccountIdentifiers

object (ExternalAccountIdentifiers)

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

subscribeWithGoogleInfo

object (SubscribeWithGoogleInfo)

Hồ sơ người dùng liên quan đến các giao dịch mua được thực hiện bằng 'Đăng ký bằng Google\39;

Trạng thái gói thuê bao

Trạng thái tiềm năng của gói thuê bao có thể ở trong đó, chẳng hạn như gói thuê bao đang hoạt động hay đã bị huỷ. Các mục trong một giao dịch mua gói thuê bao có thể là tất cả gói tự động gia hạn hoặc gói trả trước.

Enum
SUBSCRIPTION_STATE_UNSPECIFIED Trạng thái đăng ký không xác định.
SUBSCRIPTION_STATE_PENDING Đã tạo gói thuê bao nhưng đang chờ thanh toán trong quá trình đăng ký. Ở trạng thái này, tất cả các mặt hàng đang chờ thanh toán.
SUBSCRIPTION_STATE_ACTIVE Gói thuê bao đang hoạt động. – (1) Nếu gói thuê bao là một gói tự động gia hạn thì có ít nhất một mục đã được tự động gia hạn và chưa hết hạn. – (2) Nếu gói thuê bao là gói trả trước, thì có ít nhất một mặt hàng chưa hết hạn.
SUBSCRIPTION_STATE_PAUSED Gói thuê bao đã bị tạm dừng. Trạng thái này chỉ xuất hiện khi gói thuê bao là một gói tự động gia hạn. Ở trạng thái này, tất cả các mục đang ở trạng thái tạm dừng.
SUBSCRIPTION_STATE_IN_GRACE_PERIOD Gói đăng ký đang trong thời gian gia hạn. Trạng thái này chỉ xuất hiện khi gói thuê bao là một gói tự động gia hạn. Ở trạng thái này, tất cả các mục đều đang trong thời gian gia hạn.
SUBSCRIPTION_STATE_ON_HOLD Gói thuê bao đang bị tạm ngưng (tạm ngưng). Trạng thái này chỉ xuất hiện khi gói thuê bao là một gói tự động gia hạn. Ở trạng thái này, tất cả các mục đang bị tạm ngưng.
SUBSCRIPTION_STATE_CANCELED Gói thuê bao đã bị huỷ nhưng chưa hết hạn. Trạng thái này chỉ xuất hiện khi gói thuê bao là một gói tự động gia hạn. Tất cả các mục đều đã đặt autorefreshEnabled thành false.
SUBSCRIPTION_STATE_EXPIRED Gói thuê bao đã hết hạn. Tất cả các mục đều có ngày hết hạn trong quá khứ.

PausedStateContext

Thông tin dành riêng cho gói thuê bao ở trạng thái đã tạm dừng.

Biểu diễn dưới dạng JSON
{
  "autoResumeTime": string
}
Các trường
autoResumeTime

string (Timestamp format)

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

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

ContextStateContext

Thông tin dành riêng cho gói thuê bao ở trạng thái đã huỷ.

Biểu diễn dưới dạng JSON
{

  // 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.
}
Các trường
Trường liên kết cancellation_reason. Lý do gói thuê bao bị hủy. cancellation_reason chỉ có thể là một trong những giá trị sau:
userInitiatedCancellation

object (UserInitiatedCancellation)

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

systemInitiatedCancellation

object (SystemInitiatedCancellation)

Hệ thống đã huỷ gói thuê bao, chẳng hạn như do sự cố thanh toán.

developerInitiatedCancellation

object (DeveloperInitiatedCancellation)

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

replacementCancellation

object (ReplacementCancellation)

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

Hủy do người dùng thực hiện

Thông tin dành riêng cho việc huỷ do người dùng thực hiện.

Biểu diễn dưới dạng JSON
{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}
Các trường
cancelSurveyResult

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 (khảo sát lý do huỷ).

cancelTime

string (Timestamp format)

Thời gian mà người dùng hủy gói đăng ký. Người dùng có thể vẫn truy cập được gói thuê bao sau khoảng thời gian này. Sử dụng lineItems.expiration_time để xác định xem người dùng vẫn có quyền truy cập hay không.

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

CancelSurveyResult

Kết quả của cuộc khảo sát về lý do hủy đăng ký khi người dùng hủy gói đăng ký.

Biểu diễn dưới dạng JSON
{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}
Các trường
reason

enum (CancelSurveyReason)

Lý do người dùng chọn trong bản khảo sát về lý do hủy.

reasonUserInput

string

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

Lý do hủy bản khảo sát

Lý do người dùng chọn trong bản khảo sát về lý do hủy.

Enum
CANCEL_SURVEY_REASON_UNSPECIFIED Lý do hủy khảo sát chưa xác định.
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE Không dùng đủ gói đăng ký.
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES Vấn đề kỹ thuật khi sử dụng ứng dụng.
CANCEL_SURVEY_REASON_FOUND_BETTER_APP Người dùng này đã tìm thấy một ứng dụng tốt hơn.
CANCEL_SURVEY_REASON_OTHERS Các lý do khác.

Đã khởi tạo hệ thống

Thông tin dành riêng cho các yêu cầu huỷ do hệ thống của Google khởi tạo.

Đã hủy nhà phát triển

Thông tin dành riêng cho việc hủy do nhà phát triển khởi tạo.

Hủy thay thế

Thông tin dành riêng cho những yêu cầu hủy do việc thay thế gói thuê bao gây ra.

Thử nghiệm giao dịch mua

Liệu giao dịch mua gói thuê bao này có phải là một giao dịch mua thử nghiệm hay không.

Trạng thái xác nhận

Các trạng thái xác nhận có thể áp dụng cho gói thuê bao.

Enum
ACKNOWLEDGEMENT_STATE_UNSPECIFIED Trạng thái xác nhận không xác định.
ACKNOWLEDGEMENT_STATE_PENDING Gói thuê bao chưa được xác nhận.
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED Gói thuê bao được xác nhận.

Giá trị nhận dạng tài khoản bên ngoài

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

Biểu diễn dưới dạng JSON
{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}
Các trường
externalAccountId

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 hoạt động liên kết tài khoản diễn ra trong quy trình mua gói thuê bao.

obfuscatedExternalAccountId

string

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

obfuscatedExternalProfileId

string

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

Đăng ký bằng GoogleInfo

Thông tin liên quan đến các giao dịch mua được thực hiện bằng & # 39;Đăng ký bằng Google\39;.

Biểu diễn dưới dạng JSON
{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}
Các trường
profileId

string

Mã hồ sơ trên Google của người dùng khi người dùng mua gói đăng ký.

profileName

string

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

emailAddress

string

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

givenName

string

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

familyName

string

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

SubscriptionPurchaseLineItem

Thông tin cấp mặt hàng của một giao dịch mua gói thuê bao.

Biểu diễn dưới dạng JSON
{
  "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.
}
Các trường
productId

string

Mã sản phẩm đã mua (ví dụ: # 39 ; month001\39;).

expiryTime

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 RFC3339 UTC "Zulu" với độ phân giải nano giây và tối đa chín chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

Trường liên kết plan_type. Loại gói thuê bao. plan_type chỉ có thể là một trong những giá trị sau:
autoRenewingPlan

object (AutoRenewingPlan)

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

prepaidPlan

object (PrepaidPlan)

Mặt hàng này là trả trước.

Tự động gia hạn gói

Thông tin liên quan đến gói tự động gia hạn.

Biểu diễn dưới dạng JSON
{
  "autoRenewEnabled": boolean
}
Các trường
autoRenewEnabled

boolean

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

Gói trả trước

Thông tin liên quan đến gói trả trước.

Biểu diễn dưới dạng JSON
{
  "allowExtendAfterTime": string
}
Các trường
allowExtendAfterTime

string (Timestamp format)

Sau thời gian này, gói thuê bao được phép thực hiện giao dịch mua nạp tiền mới. Không hiển thị nếu gói thuê bao đã được gia hạn bằng giao dịch mua nạp tiền.

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

Phương pháp

get

Nhận siêu dữ liệu về gói thuê bao