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 ที่มีอยู่