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 alpha-2 ของผู้ใช้ ณ เวลาที่มีการให้สิทธิ์การสมัครใช้บริการ

object (SubscriptionPurchaseLineItem)

ข้อมูลระดับสินค้าสำหรับการซื้อการสมัครใช้บริการ รายการที่ซื้อในครั้งเดียวกันควรเป็นรายการทั้งหมดที่มี AutoRenewingPlan หรือทั้งหมดที่มี PrepaidPlan

string (Timestamp format)

เวลาที่การสมัครใช้บริการได้รับอนุญาต ไม่ได้ตั้งค่าสำหรับการสมัครใช้บริการที่รอดำเนินการ (สร้างการสมัครใช้บริการแล้ว แต่รอการชำระเงินระหว่างการลงชื่อสมัครใช้)

การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

enum (SubscriptionState)

สถานะปัจจุบันของการสมัครใช้บริการ

string

รหัสคำสั่งซื้อล่าสุดที่เชื่อมโยงกับการซื้อการสมัครใช้บริการ สําหรับการสมัครใช้บริการแบบต่ออายุอัตโนมัติ รหัสนี้คือรหัสคําสั่งซื้อของการลงชื่อสมัครใช้หากยังไม่ได้ต่ออายุ หรือรหัสคําสั่งซื้อตามรอบล่าสุด (คําสั่งซื้อที่สำเร็จ รอดําเนินการ หรือถูกปฏิเสธ) สำหรับการสมัครใช้บริการแบบชำระเงินล่วงหน้า รหัสนี้คือรหัสคำสั่งซื้อที่เชื่อมโยงกับโทเค็นการซื้อที่ค้นหา

string

โทเค็นการซื้อของการสมัครใช้บริการเดิม หากการสมัครใช้บริการนี้เป็นหนึ่งในรายการต่อไปนี้ * ลงชื่อสมัครใช้บริการที่ยกเลิกแล้วแต่ยังไม่หมดอายุอีกครั้ง * อัปเกรด/ดาวน์เกรดจากการสมัครใช้บริการก่อนหน้า * เปลี่ยนจากการสมัครใช้บริการแบบชำระเงินล่วงหน้าเป็นการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติ * เปลี่ยนจากการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติเป็นการสมัครใช้บริการแบบชําระล่วงหน้า * เติมเงินการสมัครใช้บริการแบบชำระล่วงหน้า

object (PausedStateContext)

บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการที่หยุดชั่วคราว แสดงเฉพาะในกรณีที่การสมัครใช้บริการมี subscriptionState เป็น SUBSCRIPTION_STATE_PAUSED อยู่

object (CanceledStateContext)

บริบทเพิ่มเติมเกี่ยวกับการยกเลิกการสมัครใช้บริการ แสดงเฉพาะในกรณีที่การสมัครใช้บริการมี subscriptionState เป็น SUBSCRIPTION_STATE_CANCELED หรือ SUBSCRIPTION_STATE_EXPIRED

object (TestPurchase)

แสดงเฉพาะในกรณีที่การซื้อการสมัครใช้บริการนี้เป็นการซื้อทดสอบ

enum (AcknowledgementState)

สถานะการยอมรับการสมัครใช้บริการ

object (ExternalAccountIdentifiers)

ตัวระบุบัญชีผู้ใช้ในบริการของบุคคลที่สาม

object (SubscribeWithGoogleInfo)

โปรไฟล์ผู้ใช้ที่เชื่อมโยงกับการซื้อที่ดำเนินการด้วย "สมัครใช้บริการด้วย Google"

{
  "autoResumeTime": string
}

string (Timestamp format)

เวลาที่จะกลับมาสมัครใช้บริการอีกครั้งโดยอัตโนมัติ

การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "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" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "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.
  "signupPromotion": {
    object (SignupPromotion)
  }
}

string

รหัสผลิตภัณฑ์ที่ซื้อ (เช่น "monthly001")

string (Timestamp format)

เวลาของการสมัครใช้บริการที่หมดอายุหรือจะหมดอายุ เว้นแต่จะมีการขยายสิทธิ์เข้าถึง (เช่น ต่ออายุ)

การประทับเวลาในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

object (AutoRenewingPlan)

รายการดังกล่าวจะต่ออายุใหม่โดยอัตโนมัติ

object (PrepaidPlan)

สินค้าเป็นแบบชำระเงินล่วงหน้า

object (OfferDetails)

รายละเอียดข้อเสนอสำหรับสินค้านี้

object (DeferredItemReplacement)

ข้อมูลสำหรับการเปลี่ยนทดแทนสินค้าที่เลื่อนออกไป

object (SignupPromotion)

รายละเอียดโปรโมชันเกี่ยวกับสินค้านี้ ตั้งค่าเฉพาะในกรณีที่ใช้โปรโมชันระหว่างการลงชื่อสมัครใช้เท่านั้น

{
  "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" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "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" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "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 ที่มีอยู่

{

  // 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)

มีการใช้รหัสแบบใช้ครั้งเดียว

object (VanityCode)

ใช้รหัสที่ต้องการแล้ว

{
  "promotionCode": string
}

string

รหัสโปรโมชัน