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

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