- ทรัพยากร: SubscriptionPurchaseV2
- SubscriptionState
- PausedStateContext
- CanceledStateContext
- UserInitiatedCancellation
- CancelSurveyResult
- CancelSurveyReason
- SystemInitiatedCancellation
- DeveloperInitiatedCancellation
- ReplacementCancellation
- TestPurchase
- AcknowledgementState
- ExternalAccountIdentifiers
- SubscribeWithGoogleInfo
- SubscriptionPurchaseLineItem
- AutoRenewingPlan
- SubscriptionItemPriceChangeDetails
- PriceChangeMode
- PriceChangeState
- InstallmentPlan
- PendingCancellation
- PlanTransitionDetails
- TransitionInfo
- TransitionState
- PriceStepUpConsentDetails
- ConsentState
- PrepaidPlan
- OfferDetails
- DeferredItemReplacement
- DeferredItemRemoval
- SignupPromotion
- OneTimeCode
- VanityCode
- ItemReplacement
- ReplacementMode
- OfferPhase
- ProrationPeriodOfferPhase
- OriginalOfferPhaseType
- FreeTrialOfferPhase
- IntroductoryPriceOfferPhase
- BasePriceOfferPhase
- DeveloperTargetedOffer
- OutOfAppPurchaseContext
- OnHoldStateContext
- RenewalDeclinedContext
- InGracePeriodStateContext
- เมธอด
ทรัพยากร: SubscriptionPurchaseV2
ระบุสถานะการซื้อการสมัครใช้บริการของผู้ใช้
| การแสดง JSON |
|---|
{ "kind": string, "regionCode": string, "lineItems": [ { object ( |
| ช่อง | |
|---|---|
kind |
ประเภทนี้แสดงออบเจ็กต์ SubscriptionPurchaseV2 ในบริการ androidpublisher |
regionCode |
รหัสประเทศ/ภูมิภาคสำหรับการเรียกเก็บเงินตามมาตรฐาน ISO 3166-1 alpha-2 ของผู้ใช้ ณ เวลาที่ให้สิทธิ์การสมัครใช้บริการ |
lineItems[] |
ข้อมูลระดับสินค้าสำหรับการซื้อการสมัครใช้บริการ รายการในการซื้อเดียวกันควรเป็น AutoRenewingPlan ทั้งหมดหรือ PrepaidPlan ทั้งหมด |
startTime |
เวลาที่ให้สิทธิ์การสมัครใช้บริการ ไม่ได้ตั้งค่าสำหรับการสมัครใช้บริการที่รอดำเนินการ (สร้างการสมัครใช้บริการแล้ว แต่กำลังรอการชำระเงินระหว่างการลงชื่อสมัครใช้) ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
subscriptionState |
สถานะปัจจุบันของการสมัครใช้บริการ |
linkedPurchaseToken |
โทเค็นการซื้อของการสมัครใช้บริการเดิม หากการสมัครใช้บริการนี้เป็นรายการใดรายการหนึ่งต่อไปนี้ * การลงชื่อสมัครใช้อีกครั้งของการสมัครใช้บริการที่ยกเลิกแต่ยังไม่สิ้นสุด * การอัปเกรด/ดาวน์เกรดจากการสมัครใช้บริการก่อนหน้า * เปลี่ยนจากการสมัครใช้บริการแบบชำระเงินล่วงหน้าเป็นการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติ * เปลี่ยนจากการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติเป็นการสมัครใช้บริการแบบชำระเงินล่วงหน้า * เติมเงินการสมัครใช้บริการแบบชำระเงินล่วงหน้า |
pausedStateContext |
บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการที่หยุดชั่วคราว จะแสดงก็ต่อเมื่อการสมัครใช้บริการมี subscriptionState เป็น SUBSCRIPTION_STATE_PAUSED เท่านั้น |
canceledStateContext |
บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการที่ยกเลิก จะแสดงก็ต่อเมื่อการสมัครใช้บริการมี subscriptionState เป็น SUBSCRIPTION_STATE_CANCELED หรือ SUBSCRIPTION_STATE_EXPIRED เท่านั้น |
testPurchase |
จะแสดงก็ต่อเมื่อการซื้อการสมัครใช้บริการนี้เป็นการซื้อทดสอบเท่านั้น |
acknowledgementState |
สถานะการรับทราบของการสมัครใช้บริการ |
externalAccountIdentifiers |
ตัวระบุบัญชีผู้ใช้ในบริการของบุคคลที่สาม |
subscribeWithGoogleInfo |
โปรไฟล์ผู้ใช้ที่เชื่อมโยงกับการซื้อที่ทำผ่าน "สมัครผ่าน Google" |
etag |
แท็กเอนทิตีที่แสดงสถานะปัจจุบันของการสมัครใช้บริการ นักพัฒนาแอปจะระบุ ETag นี้สำหรับการดำเนินการเกี่ยวกับการสมัครใช้บริการ แท็กเอนทิตีนี้จะแสดงอยู่เสมอสำหรับการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติและแบบชำระเงินล่วงหน้า |
outOfAppPurchaseContext |
บริบทเพิ่มเติมสำหรับการซื้อนอกแอป ข้อมูลนี้จะแสดงสำหรับการซื้อการสมัครใช้บริการซ้ำ (การซื้อการสมัครใช้บริการหลังจากที่การสมัครใช้บริการก่อนหน้าของผลิตภัณฑ์เดียวกันหมดอายุ) ผ่านศูนย์การสมัครใช้บริการของ Google Play เท่านั้น ระบบจะนำช่องนี้ออกหลังจากที่คุณรับทราบการสมัครใช้บริการ |
onHoldStateContext |
ไม่บังคับ บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการในสถานะ ON_HOLD จะแสดงก็ต่อเมื่อการสมัครใช้บริการมี subscriptionState เป็น SUBSCRIPTION_STATE_ON_HOLD เท่านั้น |
inGracePeriodStateContext |
ไม่บังคับ บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการในสถานะ IN_GRACE_PERIOD จะแสดงก็ต่อเมื่อการสมัครใช้บริการมี subscriptionState เป็น SUBSCRIPTION_STATE_IN_GRACE_PERIOD เท่านั้น |
SubscriptionState
สถานะที่เป็นไปได้ของการสมัครใช้บริการ เช่น มีการใช้งานอยู่หรือยกเลิกแล้ว รายการภายในการซื้อการสมัครใช้บริการอาจเป็นแพ็กเกจต่ออายุใหม่อัตโนมัติทั้งหมดหรือแพ็กเกจแบบชำระเงินล่วงหน้าทั้งหมดก็ได้
| Enum | |
|---|---|
SUBSCRIPTION_STATE_UNSPECIFIED |
สถานะการสมัครใช้บริการที่ไม่ได้ระบุ |
SUBSCRIPTION_STATE_PENDING |
สร้างการสมัครใช้บริการแล้ว แต่กำลังรอการชำระเงินระหว่างการลงชื่อสมัครใช้ ในสถานะนี้ รายการทั้งหมดกำลังรอการชำระเงิน |
SUBSCRIPTION_STATE_ACTIVE |
การสมัครใช้บริการใช้งานอยู่ - (1) หากการสมัครใช้บริการเป็นแพ็กเกจต่ออายุใหม่อัตโนมัติ อย่างน้อย 1 รายการต้องเป็น autoRenewEnabled และยังไม่หมดอายุ - (2) หากการสมัครใช้บริการเป็นแพ็กเกจแบบชำระเงินล่วงหน้า ต้องมีรายการที่ยังไม่หมดอายุอย่างน้อย 1 รายการ |
SUBSCRIPTION_STATE_PAUSED |
การสมัครใช้บริการหยุดชั่วคราว สถานะนี้จะใช้ได้เมื่อการสมัครใช้บริการเป็นแพ็กเกจต่ออายุใหม่อัตโนมัติเท่านั้น ในสถานะนี้ รายการทั้งหมดจะอยู่ในสถานะหยุดชั่วคราว |
SUBSCRIPTION_STATE_IN_GRACE_PERIOD |
การสมัครใช้บริการอยู่ในระยะเวลาผ่อนผัน สถานะนี้จะใช้ได้เมื่อการสมัครใช้บริการเป็นแพ็กเกจต่ออายุใหม่อัตโนมัติเท่านั้น ในสถานะนี้ รายการทั้งหมดจะอยู่ในระยะเวลาผ่อนผัน |
SUBSCRIPTION_STATE_ON_HOLD |
การสมัครใช้บริการถูกระงับชั่วคราว (ระงับ) สถานะนี้จะใช้ได้เมื่อการสมัครใช้บริการเป็นแพ็กเกจต่ออายุใหม่อัตโนมัติเท่านั้น ในสถานะนี้ รายการทั้งหมดจะคงไว้ชั่วคราว |
SUBSCRIPTION_STATE_CANCELED |
ยกเลิกการสมัครใช้บริการแล้ว แต่ยังไม่หมดอายุ สถานะนี้จะใช้ได้เมื่อการสมัครใช้บริการเป็นแพ็กเกจต่ออายุใหม่อัตโนมัติเท่านั้น รายการทั้งหมดมีการตั้งค่า autoRenewEnabled เป็นเท็จ |
SUBSCRIPTION_STATE_EXPIRED |
การสมัครใช้บริการหมดอายุแล้ว ทุกรายการมี expiryTime ในอดีต |
SUBSCRIPTION_STATE_PENDING_PURCHASE_CANCELED |
ระบบยกเลิกธุรกรรมที่รอดำเนินการสำหรับการสมัครใช้บริการแล้ว หากการซื้อที่รอดำเนินการนี้เป็นการสมัครใช้บริการที่มีอยู่ ให้ใช้ linkedPurchaseToken เพื่อดูสถานะปัจจุบันของการสมัครใช้บริการนั้น |
PausedStateContext
ข้อมูลเฉพาะสำหรับการสมัครใช้บริการในสถานะหยุดชั่วคราว
| การแสดง JSON |
|---|
{ "autoResumeTime": string } |
| ช่อง | |
|---|---|
autoResumeTime |
เวลาที่การสมัครใช้บริการจะกลับมาทำงานอีกครั้งโดยอัตโนมัติ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
CanceledStateContext
ข้อมูลเฉพาะสำหรับการสมัครใช้บริการในสถานะ SUBSCRIPTION_STATE_CANCELED หรือ SUBSCRIPTION_STATE_EXPIRED
| การแสดง JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "userInitiatedCancellation": { object ( |
| ช่อง | |
|---|---|
| เหตุผลที่ยกเลิกการสมัครใช้บริการ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
userInitiatedCancellation |
ผู้ใช้ยกเลิกการสมัครใช้บริการ |
systemInitiatedCancellation |
ระบบยกเลิกการสมัครใช้บริการ เช่น เนื่องจากปัญหาการเรียกเก็บเงิน |
developerInitiatedCancellation |
นักพัฒนาแอปยกเลิกการสมัครใช้บริการแล้ว |
replacementCancellation |
การสมัครใช้บริการถูกแทนที่ด้วยการสมัครใช้บริการใหม่ |
| สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง | |
UserInitiatedCancellation
ข้อมูลเฉพาะสำหรับการยกเลิกที่เริ่มโดยผู้ใช้
| การแสดง JSON |
|---|
{
"cancelSurveyResult": {
object ( |
| ช่อง | |
|---|---|
cancelSurveyResult |
ข้อมูลที่ผู้ใช้ระบุเมื่อทำตามขั้นตอนการยกเลิกการสมัครใช้บริการจนเสร็จสมบูรณ์ (แบบสำรวจเหตุผลการยกเลิก) |
cancelTime |
เวลาที่ผู้ใช้ยกเลิกการสมัครใช้บริการ ผู้ใช้อาจยังมีสิทธิ์เข้าถึงการสมัครใช้บริการหลังจากเวลานี้ ใช้ lineItems.expiry_time เพื่อตรวจสอบว่าผู้ใช้ยังมีสิทธิ์เข้าถึงอยู่หรือไม่ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
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, "developerTargetedOffers": [ { object ( |
| ช่อง | |
|---|---|
productId |
รหัสผลิตภัณฑ์ที่ซื้อ (เช่น "monthly001") |
expiryTime |
เวลาที่การสมัครใช้บริการหมดอายุหรือจะหมดอายุ เว้นแต่จะมีการขยายเวลาการเข้าถึง (เช่น ต่ออายุ) ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
developerTargetedOffers[] |
ไม่บังคับ รายละเอียดของข้อเสนอที่กำหนดเป้าหมายเป็นนักพัฒนาแอปซึ่งลงทะเบียนไว้สำหรับรายการโฆษณานี้ |
latestSuccessfulOrderId |
รหัสคำสั่งซื้อของคำสั่งซื้อล่าสุดที่สำเร็จซึ่งเชื่อมโยงกับรายการนี้ ไม่แสดงหากผู้ใช้ยังไม่ได้เป็นเจ้าของรายการ (เช่น รายการที่ถูกเลื่อนออกไปซึ่งถูกแทนที่) |
| ประเภทแพ็กเกจการสมัครใช้บริการ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
autoRenewingPlan |
รายการจะต่ออายุใหม่อัตโนมัติ |
prepaidPlan |
รายการนี้เป็นแบบชำระเงินล่วงหน้า |
| สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง | |
offerDetails |
รายละเอียดข้อเสนอสำหรับรายการนี้ |
| ช่องนี้จะปรากฏขึ้นเมื่อรายการมีการเปลี่ยนแปลงที่เลื่อนออกไป คุณสามารถนำออกหรือแทนที่ได้ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
deferredItemReplacement |
ข้อมูลสำหรับการเปลี่ยนสินค้าที่เลื่อนออกไป |
deferredItemRemoval |
ข้อมูลสำหรับการนำรายการที่เลื่อนออก |
| สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง | |
signupPromotion |
รายละเอียดโปรโมชันเกี่ยวกับรายการนี้ ตั้งค่าเฉพาะในกรณีที่มีการใช้โปรโมชันระหว่างการลงชื่อสมัครใช้ |
itemReplacement |
รายละเอียดของรายการที่ถูกแทนที่ ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อรายการนี้แทนที่รายการอื่นในการสมัครใช้บริการก่อนหน้า และจะใช้ได้เป็นเวลา 60 วันหลังจากเวลาที่ซื้อเท่านั้น |
offerPhase |
รายละเอียดระยะข้อเสนอปัจจุบันสำหรับรายการนี้ |
AutoRenewingPlan
ข้อมูลที่เกี่ยวข้องกับแพ็กเกจต่ออายุใหม่อัตโนมัติ
| การแสดง JSON |
|---|
{ "autoRenewEnabled": boolean, "recurringPrice": { object ( |
| ช่อง | |
|---|---|
autoRenewEnabled |
หากปัจจุบันการสมัครใช้บริการตั้งค่าให้ต่ออายุใหม่อัตโนมัติ เช่น ผู้ใช้ไม่ได้ยกเลิกการสมัครใช้บริการ |
recurringPrice |
ราคาตามรอบปัจจุบันของแพ็กเกจต่ออายุใหม่อัตโนมัติ โปรดทราบว่าราคาไม่รวมส่วนลดและภาษี สำหรับราคาที่ไม่รวมภาษี โปรดเรียกใช้ |
priceChangeDetails |
ข้อมูลการเปลี่ยนแปลงราคาครั้งล่าสุดของรายการนับตั้งแต่ลงชื่อสมัครใช้บริการ |
installmentDetails |
สัญญาผูกมัดของแพ็กเกจการผ่อนชำระและข้อมูลที่เกี่ยวข้องกับสถานะสำหรับแพ็กเกจต่ออายุใหม่อัตโนมัติ |
planTransitionDetails |
ข้อมูลของการเปลี่ยนแพ็กเกจที่เชื่อมโยง จะแสดงก็ต่อเมื่อแพ็กเกจนี้มีแพ็กเกจการเปลี่ยนผ่านที่เชื่อมโยงอยู่ และจะรวมเฉพาะรายละเอียดการเปลี่ยนผ่านล่าสุดที่เชื่อมโยงกับรายการเท่านั้น |
priceStepUpConsentDetails |
ข้อมูลความยินยอมในการเพิ่มราคาล่าสุด |
SubscriptionItemPriceChangeDetails
ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนแปลงราคาของรายการที่สมัครใช้บริการ
| การแสดง JSON |
|---|
{ "newPrice": { object ( |
| ช่อง | |
|---|---|
newPrice |
ราคาตามรอบใหม่สำหรับรายการที่สมัครใช้บริการ |
priceChangeMode |
โหมดการเปลี่ยนแปลงราคาจะระบุวิธีเปลี่ยนแปลงราคาของรายการที่สมัครใช้บริการ |
priceChangeState |
ระบุสถานะการเปลี่ยนแปลงราคาในปัจจุบัน |
expectedNewPriceChargeTime |
เวลาต่ออายุที่การเปลี่ยนแปลงราคาจะมีผลกับผู้ใช้ ซึ่งอาจมีการเปลี่ยนแปลง (เป็นเวลาในอนาคต) เนื่องจากกรณีที่เวลาต่ออายุเปลี่ยนไป เช่น การหยุดชั่วคราว ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อการเปลี่ยนแปลงราคายังไม่มีผล ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
PriceChangeMode
โหมดของการเปลี่ยนแปลงราคา
| Enum | |
|---|---|
PRICE_CHANGE_MODE_UNSPECIFIED |
ไม่ได้ระบุโหมดการเปลี่ยนแปลงราคา ไม่ควรตั้งค่านี้ |
PRICE_DECREASE |
หากค่าสมัครใช้บริการลดลง |
PRICE_INCREASE |
หากราคาการสมัครใช้บริการเพิ่มขึ้นและผู้ใช้ต้องยอมรับการขึ้นราคา |
OPT_OUT_PRICE_INCREASE |
หากราคาค่าสมัครใช้บริการเพิ่มขึ้นในโหมดเลือกไม่ใช้ |
PriceChangeState
สถานะของการเปลี่ยนแปลงราคา
| Enum | |
|---|---|
PRICE_CHANGE_STATE_UNSPECIFIED |
ไม่ได้ระบุสถานะการเปลี่ยนแปลงราคา ไม่ควรใช้ค่านี้ |
OUTSTANDING |
กำลังรอให้ผู้ใช้ยอมรับการเปลี่ยนแปลงราคา |
CONFIRMED |
ระบบยืนยันแล้วว่าการเปลี่ยนแปลงราคาจะเกิดขึ้นกับผู้ใช้ |
APPLIED |
การเปลี่ยนแปลงราคามีผลแล้ว กล่าวคือ ระบบเริ่มเรียกเก็บเงินจากผู้ใช้ในราคาใหม่แล้ว |
CANCELED |
ยกเลิกการเปลี่ยนแปลงราคาแล้ว |
InstallmentPlan
ข้อมูลเกี่ยวกับแพ็กเกจการผ่อนชำระ
| การแสดง JSON |
|---|
{
"initialCommittedPaymentsCount": integer,
"subsequentCommittedPaymentsCount": integer,
"remainingCommittedPaymentsCount": integer,
"pendingCancellation": {
object ( |
| ช่อง | |
|---|---|
initialCommittedPaymentsCount |
จำนวนการชำระเงินทั้งหมดที่ผู้ใช้ตกลงไว้ในตอนแรก |
subsequentCommittedPaymentsCount |
จำนวนการชำระเงินทั้งหมดที่ผู้ใช้จะต้องชำระหลังจากระยะเวลาผูกมัดแต่ละช่วง หากเว้นว่างไว้ หมายความว่าแพ็กเกจการผ่อนชำระจะเปลี่ยนกลับไปเป็นการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติตามปกติหลังจากสัญญาผูกมัดเริ่มต้นสิ้นสุดลง |
remainingCommittedPaymentsCount |
จำนวนการชำระเงินตามสัญญาผูกมัดทั้งหมดที่เหลืออยู่ซึ่งต้องชำระในรอบการต่ออายุนี้ |
pendingCancellation |
หากมี แพ็กเกจผ่อนชำระนี้จะอยู่ระหว่างรอดำเนินการยกเลิก การยกเลิกจะมีผลหลังจากที่ผู้ใช้ชำระเงินตามสัญญาผูกมัดทั้งหมดแล้วเท่านั้น |
PendingCancellation
ประเภทนี้ไม่มีช่อง
ค่านี้จะระบุว่ามีการยกเลิกที่รอดำเนินการในแพ็กเกจการผ่อนชำระเสมือนหรือไม่ การยกเลิกจะมีผลหลังจากที่ผู้ใช้ชำระเงินตามสัญญาผูกมัดทั้งหมดแล้วเท่านั้น
PlanTransitionDetails
ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนแพ็กเกจ
| การแสดง JSON |
|---|
{
"productId": string,
"basePlanId": string,
"offerId": string,
"transitionInfo": {
object ( |
| ช่อง | |
|---|---|
productId |
[ต้องระบุ] รหัสผลิตภัณฑ์ที่จะเปลี่ยนไปใช้แพ็กเกจนี้ (เช่น "monthly001") |
basePlanId |
[ต้องระบุ] รหัสแพ็กเกจเริ่มต้นที่จะเปลี่ยนไปใช้แพ็กเกจนี้ |
offerId |
รหัสข้อเสนอ แสดงเฉพาะข้อเสนอที่มีส่วนลดเท่านั้น ระบบจะตั้งค่านี้ก็ต่อเมื่อแพ็กเกจเป้าหมายไม่ใช่แพ็กเกจเริ่มต้น |
transitionInfo |
ข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแพ็กเกจที่กำหนดเวลาไว้ จะแสดงก็ต่อเมื่อมีการกำหนดเวลาการเปลี่ยนแพ็กเกจไว้เท่านั้น |
TransitionInfo
ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนแพ็กเกจตามกำหนดเวลา
| การแสดง JSON |
|---|
{ "transitionState": enum ( |
| ช่อง | |
|---|---|
transitionState |
เอาต์พุตเท่านั้น [ต้องระบุ] สถานะปัจจุบันของการเปลี่ยนผ่าน |
price |
ราคาแพ็กเกจเริ่มต้นเริ่มต้นที่จะเปลี่ยนไปใช้ |
expectedTransitionTime |
เวลาที่คาดว่าจะเปลี่ยนแพ็กเกจในปัจจุบัน ทั้งนี้อาจมีการเปลี่ยนแปลง (เป็นเวลาในอนาคต) เนื่องจากกรณีที่เวลาต่ออายุเปลี่ยนไป เช่น การหยุดชั่วคราวและการระงับบัญชี ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
TransitionState
สถานะที่เป็นไปได้ของการเปลี่ยนสถานะ
| Enum | |
|---|---|
TRANSITION_STATE_UNSPECIFIED |
สถานะการเปลี่ยนผ่านที่ไม่ได้ระบุ |
SCHEDULED |
การเปลี่ยนรุ่นมีกำหนดเวลาเริ่มต้นในอนาคต |
IN_PROGRESS |
กระบวนการเปลี่ยนผ่านได้เริ่มต้นขึ้นแล้ว และระบบได้ส่งการแจ้งเตือนการเปลี่ยนผ่านครั้งแรกไปยังผู้ใช้แล้ว |
COMPLETED |
การเปลี่ยนเสร็จสมบูรณ์แล้ว |
CANCELED |
ยกเลิกการเปลี่ยนแล้ว |
PriceStepUpConsentDetails
ข้อมูลที่เกี่ยวข้องกับการปรับราคาขึ้นซึ่งต้องได้รับความยินยอมจากผู้ใช้
| การแสดง JSON |
|---|
{ "state": enum ( |
| ช่อง | |
|---|---|
state |
เอาต์พุตเท่านั้น สถานะความยินยอมในการเพิ่มราคา |
consentDeadlineTime |
กำหนดเวลาที่ผู้ใช้ต้องให้ความยินยอม หากไม่ให้ความยินยอมภายในเวลาดังกล่าว ระบบจะยกเลิกการสมัครใช้บริการ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
newPrice |
ราคาใหม่ที่ต้องได้รับความยินยอมของผู้ใช้ |
ConsentState
สถานะความยินยอมในการเพิ่มราคา
| Enum | |
|---|---|
CONSENT_STATE_UNSPECIFIED |
สถานะความยินยอมที่ไม่ได้ระบุ |
PENDING |
ผู้ใช้ยังไม่ได้ให้ความยินยอม |
CONFIRMED |
ผู้ใช้ให้ความยินยอมแล้ว และราคาใหม่กำลังรอให้มีผล |
COMPLETED |
ผู้ใช้ให้ความยินยอมแล้ว และราคาใหม่มีผลแล้ว |
PrepaidPlan
ข้อมูลที่เกี่ยวข้องกับแพ็กเกจแบบชำระเงินล่วงหน้า
| การแสดง JSON |
|---|
{ "allowExtendAfterTime": string } |
| ช่อง | |
|---|---|
allowExtendAfterTime |
หากมี เวลาที่ระบุนี้คือเวลาที่อนุญาตให้ซื้อการเติมเงินสำหรับแพ็กเกจแบบชำระเงินล่วงหน้า จะไม่แสดงสำหรับแพ็กเกจแบบชำระเงินล่วงหน้าที่หมดอายุแล้ว ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
OfferDetails
ข้อมูลรายละเอียดข้อเสนอที่เกี่ยวข้องกับรายการโฆษณาการซื้อ
| การแสดง JSON |
|---|
{ "offerTags": [ string ], "basePlanId": string, "offerId": string } |
| ช่อง | |
|---|---|
offerTags[] |
แท็กข้อเสนอล่าสุดที่เชื่อมโยงกับข้อเสนอ ซึ่งรวมถึงแท็กที่รับค่ามาจากแพ็กเกจเริ่มต้น |
basePlanId |
รหัสแพ็กเกจเริ่มต้น แสดงสำหรับแพ็กเกจเริ่มต้นและข้อเสนอทั้งหมด |
offerId |
รหัสข้อเสนอ แสดงเฉพาะข้อเสนอที่มีส่วนลดเท่านั้น |
DeferredItemReplacement
ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนสินค้าที่เลื่อนออกไป
| การแสดง JSON |
|---|
{ "productId": string } |
| ช่อง | |
|---|---|
productId |
productId จะแทนที่ productId ที่มีอยู่ |
DeferredItemRemoval
ประเภทนี้ไม่มีช่อง
ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนสินค้าที่เลื่อนออกไป
SignupPromotion
โปรโมชันที่ใช้กับสินค้านี้เมื่อซื้อ
| การแสดง JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "oneTimeCode": { object ( |
| ช่อง | |
|---|---|
| ประเภทโปรโมชันที่ใช้กับสินค้า รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
oneTimeCode |
ใช้รหัสแบบใช้ครั้งเดียวแล้ว |
vanityCode |
ใช้รหัสที่กำหนดเองแล้ว |
| สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง | |
OneTimeCode
ประเภทนี้ไม่มีช่อง
รหัสโปรโมชันแบบใช้ครั้งเดียว
VanityCode
รหัสโปรโมชันที่กำหนดไว้ล่วงหน้าซึ่งใช้ได้หลายครั้ง
| การแสดง JSON |
|---|
{ "promotionCode": string } |
| ช่อง | |
|---|---|
promotionCode |
รหัสโปรโมชัน |
ItemReplacement
รายละเอียดเกี่ยวกับรายการโฆษณาการสมัครใช้บริการที่กำลังจะถูกแทนที่
| การแสดง JSON |
|---|
{
"productId": string,
"replacementMode": enum ( |
| ช่อง | |
|---|---|
productId |
รหัสสินค้าของบรรทัดรายการที่ต้องสมัครใช้บริการที่ถูกแทนที่ |
replacementMode |
โหมดการแทนที่ที่ใช้ระหว่างการซื้อ |
basePlanId |
รหัสแพ็กเกจเริ่มต้นของรายการโฆษณาที่สมัครใช้บริการที่ถูกแทนที่ |
offerId |
รหัสข้อเสนอของรายการโฆษณาการสมัครใช้บริการที่ถูกแทนที่ (หากมี) |
ReplacementMode
โหมดการแทนที่สำหรับการสมัครใช้บริการ
| Enum | |
|---|---|
REPLACEMENT_MODE_UNSPECIFIED |
โหมดการแทนที่ที่ไม่ได้ระบุ |
WITH_TIME_PRORATION |
ระบบจะคำนวณแพ็กเกจใหม่ตามสัดส่วนและให้เครดิตจากแพ็กเกจเดิม |
CHARGE_PRORATED_PRICE |
ระบบจะเรียกเก็บเงินจากผู้ใช้ตามสัดส่วนสำหรับแพ็กเกจใหม่ |
WITHOUT_PRORATION |
แพ็กเกจใหม่จะแทนที่แพ็กเกจเก่าโดยไม่มีการคำนวณเวลาตามสัดส่วน |
CHARGE_FULL_PRICE |
ระบบจะเรียกเก็บเงินจากผู้ใช้ในราคาเต็มสำหรับแพ็กเกจใหม่ |
DEFERRED |
ระบบจะยกเลิกแพ็กเกจเก่าและแพ็กเกจใหม่จะมีผลหลังจากแพ็กเกจเก่าหมดอายุ |
KEEP_EXISTING |
แพ็กเกจจะยังคงเหมือนเดิมเมื่อมีการเปลี่ยนอุปกรณ์นี้ |
OfferPhase
รายละเอียดเฟสของข้อเสนอ
| การแสดง JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "prorationPeriod": { object ( |
| ช่อง | |
|---|---|
| รายละเอียดเฟสของข้อเสนอ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
prorationPeriod |
ตั้งค่าเมื่อระยะข้อเสนอเป็นระยะเวลาตามสัดส่วน |
freeTrial |
ตั้งค่าเมื่อเฟสข้อเสนอเป็นช่วงทดลองใช้ฟรี |
introductoryPrice |
ตั้งค่าเมื่อเฟสข้อเสนอเป็นเฟสข้อเสนอราคาช่วงแนะนำ |
basePrice |
ตั้งค่าเมื่อเฟสของข้อเสนอเป็นเฟสการกำหนดราคาแพ็กเกจเริ่มต้น |
| สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง | |
ProrationPeriodOfferPhase
รายละเอียดเกี่ยวกับระยะข้อเสนอของระยะเวลาตามสัดส่วน
| การแสดง JSON |
|---|
{
"originalOfferPhaseType": enum ( |
| ช่อง | |
|---|---|
originalOfferPhaseType |
ประเภทระยะข้อเสนอเดิมก่อนระยะเวลาการคิดตามสัดส่วน ตั้งค่าเมื่อมีการอัปเดตระยะเวลาตามสัดส่วนจากเฟสข้อเสนอที่มีอยู่เท่านั้น |
OriginalOfferPhaseType
เฟสข้อเสนอเดิมของการชำระเงินตามข้อเสนอ หากการชำระเงินตามข้อเสนอเป็นการชำระเงินตามสัดส่วน
| Enum | |
|---|---|
ORIGINAL_OFFER_PHASE_TYPE_UNSPECIFIED |
ประเภทระยะข้อเสนอเดิมที่ไม่ระบุ |
BASE |
การสมัครใช้บริการอยู่ในช่วงราคาฐาน (เช่น ราคาเต็ม) |
INTRODUCTORY |
การสมัครใช้บริการอยู่ในเฟสราคาช่วงแนะนำ |
FREE_TRIAL |
การสมัครใช้บริการอยู่ในช่วงทดลองใช้ฟรี |
FreeTrialOfferPhase
ประเภทนี้ไม่มีช่อง
รายละเอียดเกี่ยวกับเฟสข้อเสนอช่วงทดลองใช้ฟรี
IntroductoryPriceOfferPhase
ประเภทนี้ไม่มีช่อง
รายละเอียดเกี่ยวกับเฟสข้อเสนอราคาช่วงแนะนำ
BasePriceOfferPhase
ประเภทนี้ไม่มีช่อง
รายละเอียดเกี่ยวกับเฟสข้อเสนอราคาฐาน
DeveloperTargetedOffer
ข้อมูลเกี่ยวกับข้อเสนอที่กำหนดเป้าหมายโดยนักพัฒนาแอปสำหรับรายการโฆษณาการสมัครใช้บริการ
| การแสดง JSON |
|---|
{ "offerId": string, "activateTime": string } |
| ฟิลด์ | |
|---|---|
offerId |
ไม่บังคับ รหัสข้อเสนอที่นักพัฒนาแอปสร้างขึ้นซึ่งกำหนดเป้าหมายสำหรับการสมัครใช้บริการ |
activateTime |
ไม่บังคับ เวลาที่เปิดใช้งานการกำหนดเป้าหมายข้อเสนอ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น |
OutOfAppPurchaseContext
ข้อมูลเฉพาะสำหรับการซื้อนอกแอป
| การแสดง JSON |
|---|
{
"expiredExternalAccountIdentifiers": {
object ( |
| ช่อง | |
|---|---|
expiredExternalAccountIdentifiers |
ตัวระบุบัญชีผู้ใช้จากการสมัครใช้บริการที่หมดอายุล่าสุดสำหรับ SKU นี้ |
expiredPurchaseToken |
โทเค็นการซื้อของการสมัครใช้บริการที่หมดอายุล่าสุด โทเค็นการซื้อนี้ต้องใช้เพื่อช่วยระบุผู้ใช้เท่านั้น หากลิงก์ระหว่าง purchaseToken กับผู้ใช้จัดเก็บไว้ในฐานข้อมูลของคุณ คุณจะใช้รหัสนี้เพื่อเรียก Google Developer API ไม่ได้หากรหัสหมดอายุเกิน 60 วันแล้ว |
OnHoldStateContext
บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการในสถานะ ON_HOLD
| การแสดง JSON |
|---|
{
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"renewalDeclined": {
object ( |
| ช่อง | |
|---|---|
| เหตุผลที่การสมัครใช้บริการอยู่ในสถานะ ON_HOLD รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
renewalDeclined |
ไม่บังคับ การชำระเงินสำหรับการต่ออายุถูกปฏิเสธ |
| สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง | |
RenewalDeclinedContext
บริบทที่เกี่ยวข้องกับสถานการณ์ที่การต่ออายุถูกปฏิเสธ
| การแสดง JSON |
|---|
{ "pendingOrderId": string } |
| ช่อง | |
|---|---|
pendingOrderId |
ต้องระบุ รหัสของคำสั่งซื้อที่รอดำเนินการหรือดำเนินการไม่สำเร็จซึ่งทำให้เกิดสถานะดังกล่าว |
InGracePeriodStateContext
บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการในสถานะ IN_GRACE_PERIOD
| การแสดง JSON |
|---|
{
// The following is a list of mutually exclusive fields. At most one of the
// fields will be set in a response:
"renewalDeclined": {
object ( |
| ช่อง | |
|---|---|
| เหตุผลที่การสมัครใช้บริการอยู่ในสถานะ IN_GRACE_PERIOD รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้ | |
renewalDeclined |
ไม่บังคับ การชำระเงินสำหรับการต่ออายุถูกปฏิเสธ |
| สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง | |
เมธอด |
|
|---|---|
|
เปิดใช้งานการกำหนดเป้าหมายสำหรับข้อเสนอที่เฉพาะเจาะจง |
|
ยกเลิกการซื้อการสมัครใช้บริการให้ผู้ใช้ |
|
ยกเลิกการเปลี่ยนแพ็กเกจสำหรับการสมัครใช้บริการ |
|
ปิดใช้งานการกำหนดเป้าหมายสำหรับข้อเสนอที่เฉพาะเจาะจง |
|
เลื่อนการต่ออายุการสมัครใช้บริการ |
|
รับข้อมูลเมตาเกี่ยวกับการสมัครใช้บริการ |
|
เพิกถอนการซื้อการสมัครใช้บริการของผู้ใช้ |
|
กำหนดเวลาการเปลี่ยนแพ็กเกจสำหรับการสมัครใช้บริการ |
รหัสข้อผิดพลาด
การดำเนินการของทรัพยากรนี้จะแสดงรหัสข้อผิดพลาดของ HTTP ต่อไปนี้
| รหัสข้อผิดพลาด | เหตุผล | คำอธิบาย | ความละเอียด |
|---|---|---|---|
400 / 410 |
subscriptionExpired |
การสมัครใช้บริการหมดอายุแล้วและไม่สามารถดำเนินการตามที่ขอได้ | ตรวจสอบเวลาหมดอายุของการสมัครใช้บริการ ไม่อนุญาตให้ดำเนินการนี้กับการสมัครใช้บริการที่หมดอายุแล้ว |
400 |
subscriptionInvalidArgument |
มีการระบุอาร์กิวเมนต์ที่ไม่ถูกต้องในคำขอสำหรับการสมัครใช้บริการ | ตรวจสอบเอกสารประกอบเกี่ยวกับ API และตรวจสอบว่าได้ระบุช่องที่ต้องกรอกทั้งหมดและจัดรูปแบบอย่างถูกต้องแล้ว |
400 |
invalidPurchaseState |
การซื้อไม่อยู่ในสถานะที่ถูกต้องสำหรับการดำเนินการที่ขอ เช่น คุณอาจพยายามรับทราบการซื้อที่ใช้ไปแล้วหรือยกเลิกการสมัครใช้บริการที่ไม่ได้ใช้งาน | ตรวจสอบสถานะปัจจุบันของทรัพยากรโดยใช้ Get API ที่เกี่ยวข้องก่อนพยายามดำเนินการ ตรวจสอบว่าทรัพยากรอยู่ในสถานะที่เหมาะสมสำหรับการดำเนินการ |
400 |
invalidValue |
มีการระบุค่าที่ไม่ถูกต้องในคำขอ ข้อผิดพลาดนี้มักแสดงขึ้นเมื่อโทเค็นการซื้อมีรูปแบบไม่ถูกต้องหรือไม่ถูกต้อง | แก้ไขค่าในช่องที่ไม่ถูกต้องในเนื้อหาคำขอหรือพารามิเตอร์ตามเอกสารอ้างอิง API |
400 |
prepaidSubscriptionNotSupported |
ระบบไม่รองรับการดำเนินการที่ขอสำหรับการสมัครใช้บริการแบบชำระเงินล่วงหน้า | ตรวจสอบว่าการดำเนินการเกี่ยวข้องกับประเภทการสมัครใช้บริการ ข้อผิดพลาดนี้เกิดขึ้นเฉพาะกับเมธอดอย่างเช่น Cancel |
400 |
productNotOwnedByUser |
โทเค็นการซื้อที่ระบุถูกต้อง แต่ผู้ใช้ไม่ได้เป็นเจ้าของผลิตภัณฑ์ในปัจจุบัน กรณีนี้อาจเกิดขึ้นหากมีการคืนเงิน เพิกถอน หรือการซื้อหมดอายุก่อนการรับทราบ | ตรวจสอบสถานะปัจจุบันของทรัพยากรโดยใช้ Get API ที่เกี่ยวข้องก่อนพยายามดำเนินการ ตรวจสอบว่าทรัพยากรอยู่ในสถานะที่เหมาะสมสำหรับการดำเนินการ |
400 |
purchaseTokenMismatch |
โทเค็นการซื้อที่ระบุไม่ตรงกับการซื้อ ชื่อแพ็กเกจ รหัสการสมัครใช้บริการ หรือรหัสสินค้า | ตรวจสอบว่ารายละเอียดทั้งหมดในคำขอถูกต้องและสอดคล้องกัน |
400 |
required |
ไม่มีช่องหรือพารามิเตอร์ที่จำเป็นในคำขอ | โปรดดูเอกสารประกอบของ API เพื่อให้แน่ใจว่าได้รวมช่องและพารามิเตอร์ที่จำเป็นทั้งหมดแล้ว |
400 |
unsupportedIabType |
ไม่รองรับการดำเนินการนี้สำหรับการเรียกเก็บเงินสำหรับการซื้อในแอปประเภทที่ระบุ | ตรวจสอบว่าเมธอด API เข้ากันได้กับประเภทรายการที่จัดการ |
403 |
userInsufficientPermission |
ผู้ใช้ไม่มีสิทธิ์เพียงพอที่จะดำเนินการตามที่ขอ | ตรวจสอบว่าผู้ใช้ที่ตรวจสอบสิทธิ์แล้วมีสิทธิ์ที่จำเป็นใน Google Play Console ดูรายละเอียดเพิ่มเติมได้ที่การใช้บัญชีบริการ |
404 |
notFound |
ไม่พบทรัพยากรที่ขอ | ตรวจสอบว่าตัวระบุ (เช่น โทเค็นการซื้อ, ชื่อแพ็กเกจ, รหัสสินค้า, รหัสการสมัครใช้บริการ) ถูกต้อง |
409 |
concurrentUpdate |
มีการพยายามอัปเดตออบเจ็กต์ที่กำลังอัปเดตพร้อมกัน | ลองส่งคำขออีกครั้งโดยใช้ Exponential Backoff หลีกเลี่ยงการแก้ไขทรัพยากรเดียวกันพร้อมกัน |
410 |
purchaseTokenNoLongerValid |
โทเค็นการซื้อไม่ถูกต้องอย่างถาวรเนื่องจากมีการลบบัญชีผู้ใช้ที่เชื่อมโยงหรือไม่มีบันทึกการซื้ออีกต่อไป | หยุดใช้โทเค็นการซื้อนี้ |
410 |
subscriptionNoLongerAvailable |
การซื้อการสมัครใช้บริการไม่พร้อมให้ค้นหาอีกต่อไปเนื่องจากหมดอายุมานานเกินไป | ข้อผิดพลาดนี้บ่งชี้ว่าการสมัครใช้บริการหมดอายุมานานกว่า 60 วันแล้ว คุณไม่ควรค้นหาการสมัครใช้บริการเหล่านี้อีกต่อไป |
5xx |
Generic error |
ข้อผิดพลาดทั่วไปในเซิร์ฟเวอร์ Google Play | ลองส่งคำขออีกครั้ง หากยังคงพบปัญหาอยู่ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้า Google Play หรือส่งคำขอรับการสนับสนุน ลองตรวจสอบแดชบอร์ดสถานะของ Play เพื่อดูการหยุดทำงานที่ทราบ |