REST Resource: purchases.subscriptionsv2

ทรัพยากร: SubscriptionPurchaseV2

ระบุสถานะการซื้อการสมัครใช้บริการของผู้ใช้

การแสดง JSON
{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  },
  "etag": string,
  "outOfAppPurchaseContext": {
    object (OutOfAppPurchaseContext)
  },
  "onHoldStateContext": {
    object (OnHoldStateContext)
  },
  "inGracePeriodStateContext": {
    object (InGracePeriodStateContext)
  }
}
ช่อง
kind

string

ประเภทนี้แสดงออบเจ็กต์ SubscriptionPurchaseV2 ในบริการ androidpublisher

regionCode

string

รหัสประเทศ/ภูมิภาคสำหรับการเรียกเก็บเงินตามมาตรฐาน ISO 3166-1 alpha-2 ของผู้ใช้ ณ เวลาที่ให้สิทธิ์การสมัครใช้บริการ

lineItems[]

object (SubscriptionPurchaseLineItem)

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

startTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

subscriptionState

enum (SubscriptionState)

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

linkedPurchaseToken

string

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

pausedStateContext

object (PausedStateContext)

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

canceledStateContext

object (CanceledStateContext)

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

testPurchase

object (TestPurchase)

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

acknowledgementState

enum (AcknowledgementState)

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

externalAccountIdentifiers

object (ExternalAccountIdentifiers)

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

subscribeWithGoogleInfo

object (SubscribeWithGoogleInfo)

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

etag

string

แท็กเอนทิตีที่แสดงสถานะปัจจุบันของการสมัครใช้บริการ นักพัฒนาแอปจะระบุ ETag นี้สำหรับการดำเนินการเกี่ยวกับการสมัครใช้บริการ แท็กเอนทิตีนี้จะแสดงอยู่เสมอสำหรับการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติและแบบชำระเงินล่วงหน้า

outOfAppPurchaseContext

object (OutOfAppPurchaseContext)

บริบทเพิ่มเติมสำหรับการซื้อนอกแอป ข้อมูลนี้จะแสดงสำหรับการซื้อการสมัครใช้บริการซ้ำ (การซื้อการสมัครใช้บริการหลังจากที่การสมัครใช้บริการก่อนหน้าของผลิตภัณฑ์เดียวกันหมดอายุ) ผ่านศูนย์การสมัครใช้บริการของ Google Play เท่านั้น ระบบจะนำช่องนี้ออกหลังจากที่คุณรับทราบการสมัครใช้บริการ

onHoldStateContext

object (OnHoldStateContext)

ไม่บังคับ บริบทเพิ่มเติมเกี่ยวกับการสมัครใช้บริการในสถานะ ON_HOLD จะแสดงก็ต่อเมื่อการสมัครใช้บริการมี subscriptionState เป็น SUBSCRIPTION_STATE_ON_HOLD เท่านั้น

inGracePeriodStateContext

object (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

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

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 (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of mutually exclusive fields.
}
ช่อง
เหตุผลที่ยกเลิกการสมัครใช้บริการ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
userInitiatedCancellation

object (UserInitiatedCancellation)

ผู้ใช้ยกเลิกการสมัครใช้บริการ

systemInitiatedCancellation

object (SystemInitiatedCancellation)

ระบบยกเลิกการสมัครใช้บริการ เช่น เนื่องจากปัญหาการเรียกเก็บเงิน

developerInitiatedCancellation

object (DeveloperInitiatedCancellation)

นักพัฒนาแอปยกเลิกการสมัครใช้บริการแล้ว

replacementCancellation

object (ReplacementCancellation)

การสมัครใช้บริการถูกแทนที่ด้วยการสมัครใช้บริการใหม่

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง

UserInitiatedCancellation

ข้อมูลเฉพาะสำหรับการยกเลิกที่เริ่มโดยผู้ใช้

การแสดง JSON
{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}
ช่อง
cancelSurveyResult

object (CancelSurveyResult)

ข้อมูลที่ผู้ใช้ระบุเมื่อทำตามขั้นตอนการยกเลิกการสมัครใช้บริการจนเสร็จสมบูรณ์ (แบบสำรวจเหตุผลการยกเลิก)

cancelTime

string (Timestamp format)

เวลาที่ผู้ใช้ยกเลิกการสมัครใช้บริการ ผู้ใช้อาจยังมีสิทธิ์เข้าถึงการสมัครใช้บริการหลังจากเวลานี้ ใช้ lineItems.expiry_time เพื่อตรวจสอบว่าผู้ใช้ยังมีสิทธิ์เข้าถึงอยู่หรือไม่

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

CancelSurveyResult

ผลลัพธ์ของแบบสำรวจการยกเลิกเมื่อผู้ใช้ยกเลิกการสมัครใช้บริการ

การแสดง JSON
{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}
ช่อง
reason

enum (CancelSurveyReason)

เหตุผลที่ผู้ใช้เลือกในแบบสำรวจการยกเลิก

reasonUserInput

string

ตั้งค่าสำหรับ CANCEL_SURVEY_REASON_OTHERS เท่านั้น นี่คือคำตอบแบบอิสระของผู้ใช้ต่อแบบสำรวจ

CancelSurveyReason

เหตุผลที่ผู้ใช้เลือกในแบบสำรวจการยกเลิก

Enum
CANCEL_SURVEY_REASON_UNSPECIFIED ไม่ได้ระบุเหตุผลในการยกเลิกแบบสำรวจ
CANCEL_SURVEY_REASON_NOT_ENOUGH_USAGE มีการใช้งานการสมัครใช้บริการไม่เพียงพอ
CANCEL_SURVEY_REASON_TECHNICAL_ISSUES ปัญหาทางเทคนิคขณะใช้แอป
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

string

ตัวระบุบัญชีผู้ใช้ในบริการของบุคคลที่สาม จะแสดงก็ต่อเมื่อมีการลิงก์บัญชีเป็นส่วนหนึ่งของขั้นตอนการซื้อการสมัครใช้บริการเท่านั้น

obfuscatedExternalAccountId

string

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

obfuscatedExternalProfileId

string

รหัสเวอร์ชันที่สร้างความสับสนซึ่งเชื่อมโยงกับโปรไฟล์ของผู้ใช้ในแอปของคุณโดยเฉพาะ จะแสดงก็ต่อเมื่อมีการระบุโดยใช้ 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

string

รหัสโปรไฟล์ Google ของผู้ใช้เมื่อซื้อการสมัครใช้บริการ

profileName

string

ชื่อโปรไฟล์ของผู้ใช้เมื่อซื้อการสมัครใช้บริการ

emailAddress

string

อีเมลของผู้ใช้เมื่อซื้อการสมัครใช้บริการ

givenName

string

ชื่อของผู้ใช้เมื่อซื้อการสมัครใช้บริการ

familyName

string

นามสกุลของผู้ใช้เมื่อซื้อการสมัครใช้บริการ

SubscriptionPurchaseLineItem

ข้อมูลระดับสินค้าสำหรับการซื้อการสมัครใช้บริการ

การแสดง JSON
{
  "productId": string,
  "expiryTime": string,
  "developerTargetedOffers": [
    {
      object (DeveloperTargetedOffer)
    }
  ],
  "latestSuccessfulOrderId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of mutually exclusive fields.
  "offerDetails": {
    object (OfferDetails)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  },
  "deferredItemRemoval": {
    object (DeferredItemRemoval)
  }
  // End of mutually exclusive fields.
  "signupPromotion": {
    object (SignupPromotion)
  },
  "itemReplacement": {
    object (ItemReplacement)
  },
  "offerPhase": {
    object (OfferPhase)
  }
}
ช่อง
productId

string

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

expiryTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

developerTargetedOffers[]

object (DeveloperTargetedOffer)

ไม่บังคับ รายละเอียดของข้อเสนอที่กำหนดเป้าหมายเป็นนักพัฒนาแอปซึ่งลงทะเบียนไว้สำหรับรายการโฆษณานี้

latestSuccessfulOrderId

string

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

ประเภทแพ็กเกจการสมัครใช้บริการ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
autoRenewingPlan

object (AutoRenewingPlan)

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

prepaidPlan

object (PrepaidPlan)

รายการนี้เป็นแบบชำระเงินล่วงหน้า

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง
offerDetails

object (OfferDetails)

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

ช่องนี้จะปรากฏขึ้นเมื่อรายการมีการเปลี่ยนแปลงที่เลื่อนออกไป คุณสามารถนำออกหรือแทนที่ได้ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
deferredItemReplacement

object (DeferredItemReplacement)

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

deferredItemRemoval

object (DeferredItemRemoval)

ข้อมูลสำหรับการนำรายการที่เลื่อนออก

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง
signupPromotion

object (SignupPromotion)

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

itemReplacement

object (ItemReplacement)

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

offerPhase

object (OfferPhase)

รายละเอียดระยะข้อเสนอปัจจุบันสำหรับรายการนี้

AutoRenewingPlan

ข้อมูลที่เกี่ยวข้องกับแพ็กเกจต่ออายุใหม่อัตโนมัติ

การแสดง JSON
{
  "autoRenewEnabled": boolean,
  "recurringPrice": {
    object (Money)
  },
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  },
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  },
  "priceStepUpConsentDetails": {
    object (PriceStepUpConsentDetails)
  }
}
ช่อง
autoRenewEnabled

boolean

หากปัจจุบันการสมัครใช้บริการตั้งค่าให้ต่ออายุใหม่อัตโนมัติ เช่น ผู้ใช้ไม่ได้ยกเลิกการสมัครใช้บริการ

recurringPrice

object (Money)

ราคาตามรอบปัจจุบันของแพ็กเกจต่ออายุใหม่อัตโนมัติ โปรดทราบว่าราคาไม่รวมส่วนลดและภาษี สำหรับราคาที่ไม่รวมภาษี โปรดเรียกใช้ orders.get API แทนหากต้องการรายละเอียดธุรกรรม

priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

ข้อมูลการเปลี่ยนแปลงราคาครั้งล่าสุดของรายการนับตั้งแต่ลงชื่อสมัครใช้บริการ

installmentDetails

object (InstallmentPlan)

สัญญาผูกมัดของแพ็กเกจการผ่อนชำระและข้อมูลที่เกี่ยวข้องกับสถานะสำหรับแพ็กเกจต่ออายุใหม่อัตโนมัติ

planTransitionDetails

object (PlanTransitionDetails)

ข้อมูลของการเปลี่ยนแพ็กเกจที่เชื่อมโยง จะแสดงก็ต่อเมื่อแพ็กเกจนี้มีแพ็กเกจการเปลี่ยนผ่านที่เชื่อมโยงอยู่ และจะรวมเฉพาะรายละเอียดการเปลี่ยนผ่านล่าสุดที่เชื่อมโยงกับรายการเท่านั้น

SubscriptionItemPriceChangeDetails

ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนแปลงราคาของรายการที่สมัครใช้บริการ

การแสดง JSON
{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}
ช่อง
newPrice

object (Money)

ราคาตามรอบใหม่สำหรับรายการที่สมัครใช้บริการ

priceChangeMode

enum (PriceChangeMode)

โหมดการเปลี่ยนแปลงราคาจะระบุวิธีเปลี่ยนแปลงราคาของรายการที่สมัครใช้บริการ

priceChangeState

enum (PriceChangeState)

ระบุสถานะการเปลี่ยนแปลงราคาในปัจจุบัน

expectedNewPriceChargeTime

string (Timestamp format)

เวลาต่ออายุที่การเปลี่ยนแปลงราคาจะมีผลกับผู้ใช้ ซึ่งอาจมีการเปลี่ยนแปลง (เป็นเวลาในอนาคต) เนื่องจากกรณีที่เวลาต่ออายุเปลี่ยนไป เช่น การหยุดชั่วคราว ระบบจะป้อนข้อมูลในช่องนี้ก็ต่อเมื่อการเปลี่ยนแปลงราคายังไม่มีผล

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

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 (PendingCancellation)
  }
}
ช่อง
initialCommittedPaymentsCount

integer

จำนวนการชำระเงินทั้งหมดที่ผู้ใช้ตกลงไว้ในตอนแรก

subsequentCommittedPaymentsCount

integer

จำนวนการชำระเงินทั้งหมดที่ผู้ใช้จะต้องชำระหลังจากระยะเวลาผูกมัดแต่ละช่วง หากเว้นว่างไว้ หมายความว่าแพ็กเกจการผ่อนชำระจะเปลี่ยนกลับไปเป็นการสมัครใช้บริการแบบต่ออายุใหม่อัตโนมัติตามปกติหลังจากสัญญาผูกมัดเริ่มต้นสิ้นสุดลง

remainingCommittedPaymentsCount

integer

จำนวนการชำระเงินตามสัญญาผูกมัดทั้งหมดที่เหลืออยู่ซึ่งต้องชำระในรอบการต่ออายุนี้

pendingCancellation

object (PendingCancellation)

หากมี แพ็กเกจผ่อนชำระนี้จะอยู่ระหว่างรอดำเนินการยกเลิก การยกเลิกจะมีผลหลังจากที่ผู้ใช้ชำระเงินตามสัญญาผูกมัดทั้งหมดแล้วเท่านั้น

PendingCancellation

ประเภทนี้ไม่มีช่อง

ค่านี้จะระบุว่ามีการยกเลิกที่รอดำเนินการในแพ็กเกจการผ่อนชำระเสมือนหรือไม่ การยกเลิกจะมีผลหลังจากที่ผู้ใช้ชำระเงินตามสัญญาผูกมัดทั้งหมดแล้วเท่านั้น

PlanTransitionDetails

ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนแพ็กเกจ

การแสดง JSON
{
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "transitionInfo": {
    object (TransitionInfo)
  }
}
ช่อง
productId

string

[ต้องระบุ] รหัสผลิตภัณฑ์ที่จะเปลี่ยนไปใช้แพ็กเกจนี้ (เช่น "monthly001")

basePlanId

string

[ต้องระบุ] รหัสแพ็กเกจเริ่มต้นที่จะเปลี่ยนไปใช้แพ็กเกจนี้

offerId

string

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

transitionInfo

object (TransitionInfo)

ข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแพ็กเกจที่กำหนดเวลาไว้ จะแสดงก็ต่อเมื่อมีการกำหนดเวลาการเปลี่ยนแพ็กเกจไว้เท่านั้น

TransitionInfo

ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนแพ็กเกจตามกำหนดเวลา

การแสดง JSON
{
  "transitionState": enum (TransitionState),
  "price": {
    object (Money)
  },
  "expectedTransitionTime": string
}
ช่อง
transitionState

enum (TransitionState)

เอาต์พุตเท่านั้น [ต้องระบุ] สถานะปัจจุบันของการเปลี่ยนผ่าน

price

object (Money)

ราคาแพ็กเกจเริ่มต้นเริ่มต้นที่จะเปลี่ยนไปใช้

expectedTransitionTime

string (Timestamp format)

เวลาที่คาดว่าจะเปลี่ยนแพ็กเกจในปัจจุบัน ทั้งนี้อาจมีการเปลี่ยนแปลง (เป็นเวลาในอนาคต) เนื่องจากกรณีที่เวลาต่ออายุเปลี่ยนไป เช่น การหยุดชั่วคราวและการระงับบัญชี

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

TransitionState

สถานะที่เป็นไปได้ของการเปลี่ยนสถานะ

Enum
TRANSITION_STATE_UNSPECIFIED สถานะการเปลี่ยนผ่านที่ไม่ได้ระบุ
SCHEDULED การเปลี่ยนรุ่นมีกำหนดเวลาเริ่มต้นในอนาคต
IN_PROGRESS กระบวนการเปลี่ยนผ่านได้เริ่มต้นขึ้นแล้ว และระบบได้ส่งการแจ้งเตือนการเปลี่ยนผ่านครั้งแรกไปยังผู้ใช้แล้ว
COMPLETED การเปลี่ยนเสร็จสมบูรณ์แล้ว
CANCELED ยกเลิกการเปลี่ยนแล้ว

PriceStepUpConsentDetails

ข้อมูลที่เกี่ยวข้องกับการปรับราคาขึ้นซึ่งต้องได้รับความยินยอมจากผู้ใช้

การแสดง JSON
{
  "state": enum (ConsentState),
  "consentDeadlineTime": string,
  "newPrice": {
    object (Money)
  }
}
ช่อง
state

enum (ConsentState)

เอาต์พุตเท่านั้น สถานะความยินยอมในการเพิ่มราคา

consentDeadlineTime

string (Timestamp format)

กำหนดเวลาที่ผู้ใช้ต้องให้ความยินยอม หากไม่ให้ความยินยอมภายในเวลาดังกล่าว ระบบจะยกเลิกการสมัครใช้บริการ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

newPrice

object (Money)

ราคาใหม่ที่ต้องได้รับความยินยอมของผู้ใช้

ConsentState

สถานะความยินยอมในการเพิ่มราคา

Enum
CONSENT_STATE_UNSPECIFIED สถานะความยินยอมที่ไม่ได้ระบุ
PENDING ผู้ใช้ยังไม่ได้ให้ความยินยอม
CONFIRMED ผู้ใช้ให้ความยินยอมแล้ว และราคาใหม่กำลังรอให้มีผล
COMPLETED ผู้ใช้ให้ความยินยอมแล้ว และราคาใหม่มีผลแล้ว

PrepaidPlan

ข้อมูลที่เกี่ยวข้องกับแพ็กเกจแบบชำระเงินล่วงหน้า

การแสดง JSON
{
  "allowExtendAfterTime": string
}
ช่อง
allowExtendAfterTime

string (Timestamp format)

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

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

OfferDetails

ข้อมูลรายละเอียดข้อเสนอที่เกี่ยวข้องกับรายการโฆษณาการซื้อ

การแสดง JSON
{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}
ช่อง
offerTags[]

string

แท็กข้อเสนอล่าสุดที่เชื่อมโยงกับข้อเสนอ ซึ่งรวมถึงแท็กที่รับค่ามาจากแพ็กเกจเริ่มต้น

basePlanId

string

รหัสแพ็กเกจเริ่มต้น แสดงสำหรับแพ็กเกจเริ่มต้นและข้อเสนอทั้งหมด

offerId

string

รหัสข้อเสนอ แสดงเฉพาะข้อเสนอที่มีส่วนลดเท่านั้น

DeferredItemReplacement

ข้อมูลที่เกี่ยวข้องกับการเปลี่ยนสินค้าที่เลื่อนออกไป

การแสดง JSON
{
  "productId": string
}
ช่อง
productId

string

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 (OneTimeCode)
  },
  "vanityCode": {
    object (VanityCode)
  }
  // End of mutually exclusive fields.
}
ช่อง
ประเภทโปรโมชันที่ใช้กับสินค้า รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
oneTimeCode

object (OneTimeCode)

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

vanityCode

object (VanityCode)

ใช้รหัสที่กำหนดเองแล้ว

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง

OneTimeCode

ประเภทนี้ไม่มีช่อง

รหัสโปรโมชันแบบใช้ครั้งเดียว

VanityCode

รหัสโปรโมชันที่กำหนดไว้ล่วงหน้าซึ่งใช้ได้หลายครั้ง

การแสดง JSON
{
  "promotionCode": string
}
ช่อง
promotionCode

string

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

ItemReplacement

รายละเอียดเกี่ยวกับรายการโฆษณาการสมัครใช้บริการที่กำลังจะถูกแทนที่

การแสดง JSON
{
  "productId": string,
  "replacementMode": enum (ReplacementMode),
  "basePlanId": string,
  "offerId": string
}
ช่อง
productId

string

รหัสสินค้าของบรรทัดรายการที่ต้องสมัครใช้บริการที่ถูกแทนที่

replacementMode

enum (ReplacementMode)

โหมดการแทนที่ที่ใช้ระหว่างการซื้อ

basePlanId

string

รหัสแพ็กเกจเริ่มต้นของรายการโฆษณาที่สมัครใช้บริการที่ถูกแทนที่

offerId

string

รหัสข้อเสนอของรายการโฆษณาการสมัครใช้บริการที่ถูกแทนที่ (หากมี)

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 (ProrationPeriodOfferPhase)
  },
  "freeTrial": {
    object (FreeTrialOfferPhase)
  },
  "introductoryPrice": {
    object (IntroductoryPriceOfferPhase)
  },
  "basePrice": {
    object (BasePriceOfferPhase)
  }
  // End of mutually exclusive fields.
}
ช่อง
รายละเอียดเฟสของข้อเสนอ รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
prorationPeriod

object (ProrationPeriodOfferPhase)

ตั้งค่าเมื่อระยะข้อเสนอเป็นระยะเวลาตามสัดส่วน

freeTrial

object (FreeTrialOfferPhase)

ตั้งค่าเมื่อเฟสข้อเสนอเป็นช่วงทดลองใช้ฟรี

introductoryPrice

object (IntroductoryPriceOfferPhase)

ตั้งค่าเมื่อเฟสข้อเสนอเป็นเฟสข้อเสนอราคาช่วงแนะนำ

basePrice

object (BasePriceOfferPhase)

ตั้งค่าเมื่อเฟสของข้อเสนอเป็นเฟสการกำหนดราคาแพ็กเกจเริ่มต้น

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง

ProrationPeriodOfferPhase

รายละเอียดเกี่ยวกับระยะข้อเสนอของระยะเวลาตามสัดส่วน

การแสดง JSON
{
  "originalOfferPhaseType": enum (OriginalOfferPhaseType)
}
ช่อง
originalOfferPhaseType

enum (OriginalOfferPhaseType)

ประเภทระยะข้อเสนอเดิมก่อนระยะเวลาการคิดตามสัดส่วน ตั้งค่าเมื่อมีการอัปเดตระยะเวลาตามสัดส่วนจากเฟสข้อเสนอที่มีอยู่เท่านั้น

OriginalOfferPhaseType

เฟสข้อเสนอเดิมของการชำระเงินตามข้อเสนอ หากการชำระเงินตามข้อเสนอเป็นการชำระเงินตามสัดส่วน

Enum
ORIGINAL_OFFER_PHASE_TYPE_UNSPECIFIED ประเภทระยะข้อเสนอเดิมที่ไม่ระบุ
BASE การสมัครใช้บริการอยู่ในช่วงราคาฐาน (เช่น ราคาเต็ม)
INTRODUCTORY การสมัครใช้บริการอยู่ในเฟสราคาช่วงแนะนำ
FREE_TRIAL การสมัครใช้บริการอยู่ในช่วงทดลองใช้ฟรี

FreeTrialOfferPhase

ประเภทนี้ไม่มีช่อง

รายละเอียดเกี่ยวกับเฟสข้อเสนอช่วงทดลองใช้ฟรี

IntroductoryPriceOfferPhase

ประเภทนี้ไม่มีช่อง

รายละเอียดเกี่ยวกับเฟสข้อเสนอราคาช่วงแนะนำ

BasePriceOfferPhase

ประเภทนี้ไม่มีช่อง

รายละเอียดเกี่ยวกับเฟสข้อเสนอราคาฐาน

DeveloperTargetedOffer

ข้อมูลเกี่ยวกับข้อเสนอที่กำหนดเป้าหมายโดยนักพัฒนาแอปสำหรับรายการโฆษณาการสมัครใช้บริการ

การแสดง JSON
{
  "offerId": string,
  "activateTime": string
}
ฟิลด์
offerId

string

ไม่บังคับ รหัสข้อเสนอที่นักพัฒนาแอปสร้างขึ้นซึ่งกำหนดเป้าหมายสำหรับการสมัครใช้บริการ

activateTime

string (Timestamp format)

ไม่บังคับ เวลาที่เปิดใช้งานการกำหนดเป้าหมายข้อเสนอ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

OutOfAppPurchaseContext

ข้อมูลเฉพาะสำหรับการซื้อนอกแอป

การแสดง JSON
{
  "expiredExternalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "expiredPurchaseToken": string
}
ช่อง
expiredExternalAccountIdentifiers

object (ExternalAccountIdentifiers)

ตัวระบุบัญชีผู้ใช้จากการสมัครใช้บริการที่หมดอายุล่าสุดสำหรับ SKU นี้

expiredPurchaseToken

string

โทเค็นการซื้อของการสมัครใช้บริการที่หมดอายุล่าสุด โทเค็นการซื้อนี้ต้องใช้เพื่อช่วยระบุผู้ใช้เท่านั้น หากลิงก์ระหว่าง 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 (RenewalDeclinedContext)
  }
  // End of mutually exclusive fields.
}
ช่อง
เหตุผลที่การสมัครใช้บริการอยู่ในสถานะ ON_HOLD รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
renewalDeclined

object (RenewalDeclinedContext)

ไม่บังคับ การชำระเงินสำหรับการต่ออายุถูกปฏิเสธ

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง

RenewalDeclinedContext

บริบทที่เกี่ยวข้องกับสถานการณ์ที่การต่ออายุถูกปฏิเสธ

การแสดง JSON
{
  "pendingOrderId": string
}
ช่อง
pendingOrderId

string

ต้องระบุ รหัสของคำสั่งซื้อที่รอดำเนินการหรือดำเนินการไม่สำเร็จซึ่งทำให้เกิดสถานะดังกล่าว

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 (RenewalDeclinedContext)
  }
  // End of mutually exclusive fields.
}
ช่อง
เหตุผลที่การสมัครใช้บริการอยู่ในสถานะ IN_GRACE_PERIOD รายการต่อไปนี้คือช่องที่ใช้ร่วมกันไม่ได้ ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
renewalDeclined

object (RenewalDeclinedContext)

ไม่บังคับ การชำระเงินสำหรับการต่ออายุถูกปฏิเสธ

สิ้นสุดฟิลด์ที่แยกกันโดยสิ้นเชิง

เมธอด

activateoffertargeting

เปิดใช้งานการกำหนดเป้าหมายสำหรับข้อเสนอที่เฉพาะเจาะจง

cancel

ยกเลิกการซื้อการสมัครใช้บริการให้ผู้ใช้

cancelplantransition

ยกเลิกการเปลี่ยนแพ็กเกจสำหรับการสมัครใช้บริการ

deactivateoffertargeting

ปิดใช้งานการกำหนดเป้าหมายสำหรับข้อเสนอที่เฉพาะเจาะจง

defer

เลื่อนการต่ออายุการสมัครใช้บริการ

get

รับข้อมูลเมตาเกี่ยวกับการสมัครใช้บริการ

revoke

เพิกถอนการซื้อการสมัครใช้บริการของผู้ใช้

scheduleplantransition

กำหนดเวลาการเปลี่ยนแพ็กเกจสำหรับการสมัครใช้บริการ

รหัสข้อผิดพลาด

การดำเนินการของทรัพยากรนี้จะแสดงรหัสข้อผิดพลาดของ 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 เพื่อดูการหยุดทำงานที่ทราบ