REST Resource: purchases.subscriptionsv2

ทรัพยากร: SubscriptionPurchaseV2

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

การแสดง JSON
{
  "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)
  }
}
ช่อง
kind

string

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

regionCode

string

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

lineItems[]

object (SubscriptionPurchaseLineItem)

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

startTime

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

subscriptionState

enum (SubscriptionState)

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

latestOrderId

string

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

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"

SubscriptionState

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

Enum
SUBSCRIPTION_STATE_UNSPECIFIED ไม่ได้ระบุสถานะการสมัครใช้บริการ
SUBSCRIPTION_STATE_PENDING สร้างการสมัครใช้บริการแล้ว แต่อยู่ระหว่างรอการชำระเงินระหว่างลงชื่อสมัครใช้ ในสถานะนี้ รายการทั้งหมดจะรอการชำระเงิน
SUBSCRIPTION_STATE_ACTIVE การสมัครใช้บริการทำงานอยู่ - (1) หากการสมัครใช้บริการเป็นแพ็กเกจแบบต่ออายุใหม่อัตโนมัติ อย่างน้อย 1 รายการจะเปิดใช้การต่ออายุใหม่อัตโนมัติและยังไม่หมดอายุ - (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)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

CanceledStateContext

ข้อมูลเฉพาะของการสมัครใช้บริการในสถานะ SUBSCRIPTION_STATE_CANCELED หรือ SUBSCRIPTION_STATE_EXPIRED

การแสดง JSON
{

  // 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.
}
ช่อง
ฟิลด์สหภาพ cancellation_reason สาเหตุที่การสมัครใช้บริการถูกยกเลิก cancellation_reason ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
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 เพื่อระบุว่าผู้ใช้ยังมีสิทธิ์เข้าถึงอยู่หรือไม่

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

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,

  // 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.
  "signupPromotion": {
    object (SignupPromotion)
  }
}
ช่อง
productId

string

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

expiryTime

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

ฟิลด์สหภาพ plan_type ประเภทแพ็กเกจการสมัครใช้บริการ plan_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
autoRenewingPlan

object (AutoRenewingPlan)

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

prepaidPlan

object (PrepaidPlan)

สินค้าเป็นแบบชำระเงินล่วงหน้า

offerDetails

object (OfferDetails)

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

ฟิลด์สหภาพ deferred_item_change ช่องจะปรากฏขึ้นเมื่อรายการมีการเปลี่ยนแปลงที่เลื่อนออกไป โดยสามารถนําออกหรือแทนที่ deferred_item_change ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
deferredItemReplacement

object (DeferredItemReplacement)

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

signupPromotion

object (SignupPromotion)

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

AutoRenewingPlan

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

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

boolean

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

recurringPrice

object (Money)

ราคาตามรอบปัจจุบันของแพ็กเกจแบบต่ออายุใหม่อัตโนมัติ

priceChangeDetails

object (SubscriptionItemPriceChangeDetails)

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

installmentDetails

object (InstallmentPlan)

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

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)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

PriceChangeMode

โหมดของการเปลี่ยนแปลงราคา

Enum
PRICE_CHANGE_MODE_UNSPECIFIED ไม่ได้ระบุโหมดการเปลี่ยนแปลงราคา คุณไม่ควรตั้งค่านี้
PRICE_DECREASE หากค่าสมัครใช้บริการมีราคาลดลง
PRICE_INCREASE หากค่าสมัครใช้บริการมีราคาสูงขึ้นและผู้ใช้ต้องยอมรับ
OPT_OUT_PRICE_INCREASE หากค่าสมัครใช้บริการมีราคาสูงขึ้นด้วยโหมดไม่ได้ขอให้ผู้ใช้ยินยอม

PriceChangeState

สถานะของการเปลี่ยนแปลงราคา

Enum
PRICE_CHANGE_STATE_UNSPECIFIED ไม่มีการระบุสถานะการเปลี่ยนแปลงราคา ไม่ควรใช้ค่านี้
OUTSTANDING กำลังรอให้ผู้ใช้ยอมรับการเปลี่ยนแปลงราคา
CONFIRMED ยืนยันแล้วว่าการเปลี่ยนแปลงราคามีผลกับผู้ใช้
APPLIED การเปลี่ยนแปลงราคามีผลบังคับใช้แล้ว เช่น ระบบเริ่มเรียกเก็บเงินจากผู้ใช้ในราคาใหม่

InstallmentPlan

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

การแสดง JSON
{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}
ช่อง
initialCommittedPaymentsCount

integer

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

subsequentCommittedPaymentsCount

integer

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

remainingCommittedPaymentsCount

integer

จํานวนการชําระเงินทั้งหมดที่ตกลงไว้ซึ่งต้องชําระในรอบการต่ออายุนี้

pendingCancellation

object (PendingCancellation)

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

PendingCancellation

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

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

PrepaidPlan

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

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

string (Timestamp format)

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

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

OfferDetails

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

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

string

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

basePlanId

string

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

offerId

string

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

DeferredItemReplacement

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

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

string

productId ที่จะแทนที่ productId ที่มีอยู่

SignupPromotion

โปรโมชันที่ใช้กับสินค้านี้เมื่อซื้อ

การแสดง JSON
{

  // Union field promotion_type can be only one of the following:
  "oneTimeCode": {
    object (OneTimeCode)
  },
  "vanityCode": {
    object (VanityCode)
  }
  // End of list of possible types for union field promotion_type.
}
ช่อง
ฟิลด์สหภาพ promotion_type ประเภทโปรโมชันที่ใช้กับสินค้า promotion_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
oneTimeCode

object (OneTimeCode)

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

vanityCode

object (VanityCode)

ใช้รหัสที่ต้องการแล้ว

OneTimeCode

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

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

VanityCode

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

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

string

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

เมธอด

get

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

revoke

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