Method: purchases.subscriptionsv2.revoke

subscriptionsv2.revoke a subscription purchase for the user.

คำขอ HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:revoke

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
packageName

string

ต้องระบุ แพ็กเกจของแอปพลิเคชันที่ซื้อการสมัครใช้บริการนี้ (เช่น "com.some.thing")
token

string

ต้องระบุ โทเค็นที่ระบุให้กับอุปกรณ์ของผู้ใช้เมื่อซื้อการสมัครใช้บริการ

เนื้อความของคำขอ

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{   "revocationContext": {     object (RevocationContext)   } }
ช่อง
revocationContext

object (RevocationContext)

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

เนื้อหาการตอบกลับ

หากดำเนินการสำเร็จ เนื้อหาการตอบกลับจะว่างเปล่า

ตัวอย่าง

ตัวอย่างคําขอมีดังนี้

curl -X POST \   'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptionsv2/tokens/sample_purchase_token:revoke' \   -H 'Accept: application/json' \   -H 'Content-Type: application/json' \   -d '{     "revocationContext": {       "proratedRefund": {}     }   }'

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/androidpublisher

RevocationContext

บริบทการเพิกถอนของ API purchases.subscriptionsv2.revoke

การแสดง JSON 
{    // Union field RefundType can be only one of the following:   "fullRefund": {     object (FullRefund)   },   "proratedRefund": {     object (ProratedRefund)   },   "itemBasedRefund": {     object (ItemBasedRefund)   }   // End of list of possible types for union field RefundType. }
ช่อง
ฟิลด์สหภาพ RefundType กำหนดประเภทของเงินคืนที่ควรได้รับ คุณต้องระบุประเภทการคืนเงินเป็นส่วนหนึ่งของคำขอที่ถูกต้อง RefundType ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
fullRefund

object (FullRefund)

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

object (ProratedRefund)

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

object (ItemBasedRefund)

ไม่บังคับ ใช้เมื่อควรคืนเงินสำหรับรายการที่เฉพาะเจาะจงในการสมัครใช้บริการที่มีรายการเสริม

FullRefund

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

ใช้เพื่อระบุว่าประเภทการคืนเงินใน RevocationContext เป็นการคืนเงินเต็มจำนวนหรือไม่

ProratedRefund

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

ใช้เพื่อระบุว่าประเภทเงินคืนใน RevocationContext เป็นการคืนเงินตามสัดส่วนหรือไม่

ItemBasedRefund

ใช้เพื่อระบุรายการที่เฉพาะเจาะจงที่จะเพิกถอนในการสมัครใช้บริการที่มีหลายรายการ

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

string

ต้องระบุ หากการสมัครใช้บริการเป็นการสมัครใช้บริการที่มีส่วนเสริม ให้ระบุรหัสผลิตภัณฑ์ของรายการที่ต้องยกเลิกการสมัครใช้บริการ