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

รหัสเวอร์ชันที่ปรับให้ยากต่อการอ่าน (Obfuscate) ซึ่งเชื่อมโยงกับบัญชีของผู้ใช้ในแอปของคุณโดยเฉพาะ แสดงสำหรับการซื้อต่อไปนี้: * หากมีการลิงก์บัญชีที่เป็นส่วนหนึ่งของขั้นตอนการซื้อการสมัครใช้บริการ * ระบุโดยใช้ https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid เมื่อทำการซื้อ

string

รหัสเวอร์ชันที่ปรับให้ยากต่อการอ่าน (Obfuscate) ซึ่งเชื่อมโยงกับโปรไฟล์ของผู้ใช้ในแอปของคุณโดยไม่ซ้ำกัน แสดงหากระบุโดยใช้ 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" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "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" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 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 ที่มีอยู่