- แหล่งข้อมูล: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- เมธอด
ทรัพยากร: SubscriptionPurchaseV2
ระบุสถานะการซื้อการสมัครใช้บริการของผู้ใช้
การแสดง JSON |
---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
ช่อง | |
---|---|
kind |
ประเภทนี้แสดงออบเจ็กต์ SubscriptionPurchaseV2 ในบริการ androidpublisher |
regionCode |
รหัสประเทศ/ภูมิภาคสำหรับการเรียกเก็บเงินตาม ISO 3166-1 alpha-2 ของผู้ใช้ ณ เวลาที่สมัครใช้บริการ |
lineItems[] |
ข้อมูลระดับสินค้าสำหรับการสมัครใช้บริการ สินค้าทั้งหมดในการซื้อเดียวกันควรใช้ AutoRenewingPlan หรือใช้ PrepaidPlan ทั้งหมด |
startTime |
เวลาที่การสมัครใช้บริการได้รับอนุมัติ ไม่ได้ตั้งค่าสำหรับการสมัครใช้บริการที่รอดำเนินการ (สร้างการสมัครใช้บริการแล้ว แต่กำลังรอการชำระเงินระหว่างลงชื่อสมัครใช้) การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
subscriptionState |
สถานะปัจจุบันของการสมัครใช้บริการ |
latestOrderId |
รหัสคำสั่งซื้อของคำสั่งซื้อล่าสุดที่เกี่ยวข้องกับการสมัครใช้บริการ สำหรับการต่ออายุการสมัครอัตโนมัติ นี่คือรหัสคำสั่งซื้อของคำสั่งซื้อที่ลงชื่อสมัครใช้หากคุณยังไม่ได้ต่ออายุ หรือรหัสคำสั่งซื้อตามรอบล่าสุด (คำสั่งซื้อที่สำเร็จ รอดำเนินการ หรือถูกปฏิเสธ) สำหรับการสมัครใช้บริการแบบชำระล่วงหน้า นี่คือรหัสคำสั่งซื้อที่เชื่อมโยงกับโทเค็นการซื้อที่ค้นหา |
linkedPurchaseToken |
โทเค็นการซื้อของการสมัครใช้บริการเดิม หากการสมัครใช้บริการนี้เป็นหนึ่งในรายการต่อไปนี้ * การลงชื่อสมัครใช้อีกครั้งสำหรับการสมัครใช้บริการที่ยกเลิกแล้วแต่ยังไม่สิ้นสุด * อัปเกรด/ดาวน์เกรดจากการสมัครใช้บริการก่อนหน้า * เปลี่ยนจากการสมัครใช้บริการแบบชำระล่วงหน้าเป็นการต่ออายุใหม่อัตโนมัติ * เปลี่ยนจากการสมัครใช้บริการแบบต่ออายุใหม่เป็นการชําระเงินแบบชําระล่วงหน้า * เติมเงินการสมัครใช้บริการแบบชำระล่วงหน้า |
pausedStateContext |
บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการที่หยุดชั่วคราว ปรากฏก็ต่อเมื่อการสมัครใช้บริการมี subscriptionState SUBSCRIPTION_STATE_PAUSED ไว้เท่านั้น |
canceledStateContext |
บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการที่ยกเลิกแล้ว แสดงเมื่อการสมัครใช้บริการปัจจุบันมี subscriptionState SUBSCRIPTION_STATE_CANCELED เท่านั้น |
testPurchase |
แสดงเมื่อการซื้อการสมัครใช้บริการนี้เป็นการซื้อทดสอบเท่านั้น |
acknowledgementState |
สถานะการรับทราบการสมัครใช้บริการ |
externalAccountIdentifiers |
ตัวระบุบัญชีผู้ใช้ในบริการของบุคคลที่สาม |
subscribeWithGoogleInfo |
โปรไฟล์ผู้ใช้ที่เชื่อมโยงกับการซื้อที่ดำเนินการด้วย "สมัครผ่าน Google" |
SubscriptionState
สถานะที่เป็นไปได้ของการสมัครใช้บริการ เช่น อยู่ในสถานะใช้งานอยู่หรือถูกยกเลิก รายการที่อยู่ในการซื้อการสมัครใช้บริการอาจเป็นแพ็กเกจแบบต่ออายุใหม่อัตโนมัติหรือแพ็กเกจแบบชำระเงินล่วงหน้าทั้งหมด
Enum | |
---|---|
SUBSCRIPTION_STATE_UNSPECIFIED |
สถานะการสมัครใช้บริการที่ไม่ระบุ |
SUBSCRIPTION_STATE_PENDING |
สร้างการสมัครใช้บริการแล้ว แต่กำลังรอการชำระเงินระหว่างลงชื่อสมัครใช้ อยู่ในสถานะนี้ รายการทั้งหมดกำลังรอการชำระเงิน |
SUBSCRIPTION_STATE_ACTIVE |
การสมัครใช้บริการทำงานอยู่ - (1) หากการสมัครใช้บริการเป็นแบบต่ออายุใหม่อัตโนมัติ จะมีอย่างน้อยหนึ่งรายการเป็น autoRenewEnabled และยังไม่หมดอายุ - (2) หากการสมัครใช้บริการเป็นแพ็กเกจชำระล่วงหน้า อย่างน้อย 1 รายการยังไม่หมดอายุ |
SUBSCRIPTION_STATE_PAUSED |
การสมัครใช้บริการหยุดชั่วคราว รัฐจะใช้ได้เฉพาะเมื่อการสมัครใช้บริการเป็นแพ็กเกจแบบต่ออายุใหม่อัตโนมัติเท่านั้น ในกรณีนี้ ทุกรายการจะอยู่ในสถานะหยุดชั่วคราว |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
การสมัครใช้บริการอยู่ในระยะเวลาผ่อนผัน รัฐจะใช้ได้เฉพาะเมื่อการสมัครใช้บริการเป็นแพ็กเกจแบบต่ออายุใหม่อัตโนมัติเท่านั้น อยู่ในสถานะนี้ รายการทั้งหมดจะอยู่ในระยะเวลาผ่อนผัน |
SUBSCRIPTION_STATE_ON_HOLD |
การสมัครใช้บริการถูกระงับ (ระงับ) รัฐจะใช้ได้เฉพาะเมื่อการสมัครใช้บริการเป็นแพ็กเกจแบบต่ออายุใหม่อัตโนมัติเท่านั้น ในสถานะนี้ รายการทั้งหมดจะถูกระงับ |
SUBSCRIPTION_STATE_CANCELED |
การสมัครใช้บริการถูกยกเลิกแต่ยังไม่หมดอายุ รัฐจะใช้ได้เฉพาะเมื่อการสมัครใช้บริการเป็นแพ็กเกจแบบต่ออายุใหม่อัตโนมัติเท่านั้น ตั้งค่า autoRenewEnabled รายการทั้งหมดเป็น "เท็จ" |
SUBSCRIPTION_STATE_EXPIRED |
การสมัครใช้บริการหมดอายุแล้ว สินค้าทั้งหมดมีเวลาหมดอายุในอดีต |
PausedStateContext
ข้อมูลที่เจาะจงกับการสมัครใช้บริการในสถานะหยุดชั่วคราว
การแสดง JSON |
---|
{ "autoResumeTime": string } |
ช่อง | |
---|---|
autoResumeTime |
เวลาที่การสมัครใช้บริการจะกลับมาทำงานอีกครั้งโดยอัตโนมัติ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
CanceledStateContext
ข้อมูลเฉพาะที่เกี่ยวกับการสมัครใช้บริการที่มีสถานะถูกยกเลิก
การแสดง JSON |
---|
{ // Union field |
ช่อง | |
---|---|
ฟิลด์การรวม cancellation_reason เหตุผลที่ยกเลิกการสมัครใช้บริการ cancellation_reason ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
userInitiatedCancellation |
ผู้ใช้ยกเลิกการสมัครใช้บริการ |
systemInitiatedCancellation |
การสมัครใช้บริการถูกยกเลิกโดยระบบ เช่น มีปัญหาเกี่ยวกับการเรียกเก็บเงิน |
developerInitiatedCancellation |
นักพัฒนาซอฟต์แวร์ยกเลิกการสมัครใช้บริการ |
replacementCancellation |
การสมัครใช้บริการถูกแทนที่โดยการสมัครใช้บริการใหม่ |
UserInitiatedCancellation
ข้อมูลที่เจาะจงเกี่ยวกับการยกเลิกที่เริ่มต้นโดยผู้ใช้
การแสดง JSON |
---|
{
"cancelSurveyResult": {
object ( |
ช่อง | |
---|---|
cancelSurveyResult |
ข้อมูลที่ผู้ใช้ให้ไว้เมื่อผู้ใช้ทำตามขั้นตอนการยกเลิกการสมัครใช้บริการจนเสร็จสมบูรณ์ (แบบสำรวจเหตุผลในการยกเลิก) |
cancelTime |
เวลาที่ผู้ใช้ยกเลิกการสมัครใช้บริการ ผู้ใช้อาจยังมีสิทธิ์เข้าถึงการสมัครใช้บริการหลังเวลาดังกล่าว ใช้ lineItems.expiry_time เพื่อระบุว่าผู้ใช้ยังมีสิทธิ์เข้าถึงอยู่หรือไม่ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
CancelSurveyResult
ผลการสำรวจการยกเลิกเมื่อผู้ใช้ยกเลิกการสมัครใช้บริการ
การแสดง JSON |
---|
{
"reason": enum ( |
ช่อง | |
---|---|
reason |
เหตุผลที่ผู้ใช้เลือกในแบบสำรวจการยกเลิก |
reasonUserInput |
ตั้งค่าไว้สำหรับ CANCEL_SURVEY_REASON_OTHERS เท่านั้น นี่คือคำตอบแบบอิสระของผู้ใช้สำหรับแบบสำรวจ |
CancelSurveyReason
เหตุผลที่ผู้ใช้เลือกในแบบสำรวจการยกเลิก
Enum | |
---|---|
CANCEL_SURVEY_REASON_UNSPECIFIED |
ไม่ได้ระบุเหตุผลที่ยกเลิกแบบสำรวจ |
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE |
มีการสมัครใช้บริการไม่เพียงพอ |
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES |
ปัญหาทางเทคนิคขณะใช้แอป |
CANCEL_SURVEY_REASON_COST_RELATED |
ปัญหาเกี่ยวกับค่าใช้จ่าย |
CANCEL_SURVEY_REASON_FOUND_BETTER_APP |
ผู้ใช้พบแอปที่ดีกว่า |
CANCEL_SURVEY_REASON_OTHERS |
เหตุผลอื่นๆ |
SystemInitiatedCancellation
ประเภทนี้ไม่มีช่อง
ข้อมูลเฉพาะของการยกเลิกที่ดำเนินการโดยระบบของ Google
DeveloperInitiatedCancellation
ประเภทนี้ไม่มีช่อง
ข้อมูลเฉพาะของการยกเลิกที่เริ่มต้นโดยนักพัฒนาแอป
ReplacementCancellation
ประเภทนี้ไม่มีช่อง
ข้อมูลที่เจาะจงเกี่ยวกับการยกเลิกที่เกิดจากการเปลี่ยนการสมัครใช้บริการ
TestPurchase
ประเภทนี้ไม่มีช่อง
การซื้อการสมัครใช้บริการนี้เป็นการซื้อทดสอบหรือไม่
AcknowledgementState
สถานะการรับทราบที่เป็นไปได้สําหรับการสมัครใช้บริการ
Enum | |
---|---|
ACKNOWLEDGEMENT_STATE_UNSPECIFIED |
สถานะการรับทราบที่ไม่ระบุ |
ACKNOWLEDGEMENT_STATE_PENDING |
ยังไม่มีการยอมรับการสมัครใช้บริการ |
ACKNOWLEDGEMENT_STATE_ACKNOWLEDGED |
รับทราบการสมัครใช้บริการแล้ว |
ExternalAccountIdentifiers
ตัวระบุบัญชีผู้ใช้ในบริการของบุคคลที่สาม
การแสดง JSON |
---|
{ "externalAccountId": string, "obfuscatedExternalAccountId": string, "obfuscatedExternalProfileId": string } |
ช่อง | |
---|---|
externalAccountId |
ตัวระบุบัญชีผู้ใช้ในบริการของบุคคลที่สาม แสดงเมื่อการลิงก์บัญชีเกิดขึ้นเป็นส่วนหนึ่งของขั้นตอนการซื้อการสมัครใช้บริการเท่านั้น |
obfuscatedExternalAccountId |
รหัสเวอร์ชันที่สร้างความสับสนซึ่งเชื่อมโยงกับบัญชีของผู้ใช้ในแอปอย่างไม่ซ้ำกัน แสดงสำหรับการซื้อต่อไปนี้ * หากมีการลิงก์บัญชีเป็นส่วนหนึ่งของขั้นตอนการซื้อการสมัครใช้บริการ * โดยระบุโดยใช้ https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid เมื่อทำการซื้อ |
obfuscatedExternalProfileId |
เวอร์ชันที่สร้างความสับสนของรหัสที่เชื่อมโยงกับโปรไฟล์ผู้ใช้ในแอปอย่างไม่ซ้ำกัน แสดงเมื่อระบุโดยใช้ https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid ตอนทำการซื้อเท่านั้น |
SubscribeWithGoogleInfo
ข้อมูลที่เชื่อมโยงกับการซื้อที่ดำเนินการด้วย "สมัครผ่าน Google"
การแสดง JSON |
---|
{ "profileId": string, "profileName": string, "emailAddress": string, "givenName": string, "familyName": string } |
ช่อง | |
---|---|
profileId |
รหัสโปรไฟล์ Google ของผู้ใช้เมื่อซื้อการสมัครใช้บริการ |
profileName |
ชื่อโปรไฟล์ของผู้ใช้เมื่อสมัครใช้บริการ |
emailAddress |
อีเมลของผู้ใช้เมื่อสมัครใช้บริการ |
givenName |
ชื่อที่ระบุของผู้ใช้เมื่อซื้อการสมัครใช้บริการ |
familyName |
นามสกุลของผู้ใช้เมื่อซื้อการสมัครใช้บริการ |
SubscriptionPurchaseLineItem
ข้อมูลระดับสินค้าสำหรับการสมัครใช้บริการ
การแสดง JSON |
---|
{ "productId": string, "expiryTime": string, // Union field |
ช่อง | |
---|---|
productId |
รหัสผลิตภัณฑ์ที่ซื้อ (เช่น "month001") |
expiryTime |
เวลาที่การสมัครใช้บริการหมดอายุหรือจะหมดอายุ เว้นแต่ว่าจะมีการขยายสิทธิ์เข้าถึง (เช่น ต่ออายุ) การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
ฟิลด์การรวม plan_type ประเภทแพ็กเกจการสมัครใช้บริการ plan_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
autoRenewingPlan |
รายการนี้ต่ออายุใหม่อัตโนมัติ |
prepaidPlan |
รายการนี้เป็นแบบชำระล่วงหน้า |
offerDetails |
รายละเอียดข้อเสนอสำหรับไอเทมนี้ |
ฟิลด์การรวม deferred_item_change ระบบจะแสดงช่องนี้เมื่อรายการมีการเปลี่ยนแปลงที่เลื่อนเวลาออกไป ซึ่งอาจนำออกหรือแทนที่ก็ได้ deferred_item_change ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
deferredItemReplacement |
ข้อมูลสำหรับการเปลี่ยนสินค้าที่มีการเลื่อนเวลา |
AutoRenewingPlan
ข้อมูลเกี่ยวกับแพ็กเกจต่ออายุใหม่อัตโนมัติ
การแสดง JSON |
---|
{
"autoRenewEnabled": boolean,
"priceChangeDetails": {
object ( |
ช่อง | |
---|---|
autoRenewEnabled |
หากการสมัครใช้บริการตั้งค่าการต่ออายุอัตโนมัติอยู่ เช่น ผู้ใช้ไม่ได้ยกเลิกการสมัครใช้บริการ |
priceChangeDetails |
ข้อมูลการเปลี่ยนแปลงราคาล่าสุดสำหรับสินค้าตั้งแต่ลงชื่อสมัครใช้บริการ |
SubscriptionItemPriceChangeDetails
ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนแปลงราคาของรายการสมัครใช้บริการ
การแสดง JSON |
---|
{ "newPrice": { object ( |
ช่อง | |
---|---|
newPrice |
ราคาตามรอบใหม่สำหรับรายการสมัครรับข้อมูล |
priceChangeMode |
โหมดการเปลี่ยนราคาจะระบุการเปลี่ยนแปลงราคารายการสมัครใช้บริการ |
priceChangeState |
ระบุการเปลี่ยนแปลงราคาในขณะนี้ |
expectedNewPriceChargeTime |
เวลาต่ออายุที่การเปลี่ยนแปลงราคาจะมีผลสำหรับผู้ใช้ อาจมีการเปลี่ยนแปลงได้(ในอนาคต) เนื่องจากวันที่ต่ออายุมีการเปลี่ยนแปลง เช่น การหยุดชั่วคราว ระบบจะป้อนข้อมูลในช่องนี้ในกรณีที่การเปลี่ยนแปลงราคาไม่มีผลเท่านั้น การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
PriceChangeMode
โหมดของการเปลี่ยนแปลงราคา
Enum | |
---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
ไม่ได้ระบุโหมดการเปลี่ยนราคา ไม่ควรกำหนดค่านี้ |
PRICE_DECREASE |
หากราคาการสมัครใช้บริการลดลง |
PRICE_INCREASE |
หากราคาการสมัครใช้บริการเพิ่มขึ้นและผู้ใช้ต้องยอมรับ |
OPT_OUT_PRICE_INCREASE |
หากราคาการสมัครใช้บริการเพิ่มขึ้นตามโหมดเลือกไม่ใช้ |
PriceChangeState
สถานะของการเปลี่ยนแปลงราคา
Enum | |
---|---|
PRICE_CHANGE_STATE_UNSPECIFIED |
ไม่ได้ระบุสถานะการเปลี่ยนแปลงราคา คุณไม่ควรใช้ค่านี้ |
OUTSTANDING |
กำลังรอให้ผู้ใช้ยอมรับการเปลี่ยนแปลงราคา |
CONFIRMED |
การเปลี่ยนแปลงราคาได้รับการยืนยันแล้วว่าจะเกิดขึ้นกับผู้ใช้ |
APPLIED |
การเปลี่ยนแปลงราคาจะมีผล กล่าวคือ เริ่มมีการเรียกเก็บเงินจากผู้ใช้ในราคาใหม่ |
PrepaidPlan
ข้อมูลเกี่ยวกับแพ็กเกจแบบชำระเงินล่วงหน้า
การแสดง JSON |
---|
{ "allowExtendAfterTime": string } |
ช่อง | |
---|---|
allowExtendAfterTime |
หากมี ซึ่งก็คือเวลาที่อนุญาตให้ซื้อแบบเติมเงินสำหรับแพ็กเกจแบบชำระเงินล่วงหน้าได้ ระบบจะไม่แสดงแพ็กเกจแบบชำระเงินล่วงหน้าที่หมดอายุแล้ว การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
OfferDetails
เสนอข้อมูลรายละเอียดที่เกี่ยวข้องกับบรรทัดรายการการซื้อ
การแสดง JSON |
---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
ช่อง | |
---|---|
offerTags[] |
แท็กข้อเสนอล่าสุดที่เชื่อมโยงกับข้อเสนอ โดยประกอบไปด้วยแท็กที่รับช่วงมาจากแพ็กเกจเริ่มต้น |
basePlanId |
รหัสแพ็กเกจเริ่มต้น แสดงสำหรับแพ็กเกจเริ่มต้นและข้อเสนอทั้งหมด |
offerId |
รหัสข้อเสนอ แสดงสำหรับข้อเสนอที่มีส่วนลดเท่านั้น |
DeferredItemReplacement
ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนสินค้าที่มีการเลื่อนเวลา
การแสดง JSON |
---|
{ "productId": string } |
ช่อง | |
---|---|
productId |
productId จะมาแทนที่ productId ที่มีอยู่ |
วิธีการ |
|
---|---|
|
รับข้อมูลเมตาเกี่ยวกับการสมัครใช้บริการ |
|
เพิกถอนการซื้อการสมัครใช้บริการให้กับผู้ใช้ |