Method: purchases.subscriptions.cancel

• คำขอ HTTP
• พารามิเตอร์เส้นทาง
• เนื้อความของคำขอ
  • การแสดง JSON
• เนื้อหาการตอบกลับ
• ขอบเขตการให้สิทธิ์
• CancellationType
• ลองใช้งาน

ยกเลิกการซื้อการสมัครใช้บริการของผู้ใช้ การสมัครใช้บริการจะยังคงใช้งานได้จนถึงเวลาหมดอายุ

คำขอ HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancel

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

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

พารามิเตอร์
packageName	string ชื่อแพ็กเกจของแอปพลิเคชันที่ซื้อการสมัครใช้บริการนี้ (เช่น "com.some.thing")
subscriptionId	string หมายเหตุ: ตั้งแต่วันที่ 21 พฤษภาคม 2025 เป็นต้นไป คุณไม่จำเป็นต้องระบุ subscriptionId และเราไม่แนะนำให้ระบุสำหรับการสมัครใช้บริการที่มีส่วนเสริม รหัสการสมัครใช้บริการที่ซื้อ (เช่น "monthly001")
token	string โทเค็นที่ระบุให้กับอุปกรณ์ของผู้ใช้เมื่อซื้อการสมัครใช้บริการ

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

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

การแสดง JSON
{ "cancellationType": enum (CancellationType) }

ช่อง
cancellationType	enum (CancellationType) ไม่บังคับ ประเภทการยกเลิกการสมัครใช้บริการที่ซื้อ โปรดทราบว่าช่องนี้ใช้ได้ในคําขอ HTTP เท่านั้น และไม่พร้อมใช้งานในคลังเพลงของไคลเอ็นต์

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

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

ตัวอย่าง

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

curl -X POST \
  -H "Accept: application/json" \
  "https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/purchases/subscriptions/monthly.premium.plan/tokens/EXAMPLE_TOKEN_STRING_12345:cancel"

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

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

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

CancellationType

ประเภทการยกเลิกที่นักพัฒนาแอปขอ

Enum
CANCELLATION_TYPE_UNSPECIFIED	ไม่ได้ระบุประเภทการยกเลิก
USER_REQUESTED_STOP_RENEWALS	ผู้ใช้ขอยกเลิกและสามารถกู้คืนการสมัครใช้บริการได้ การดำเนินการนี้จะหยุดเฉพาะการต่ออายุการสมัครใช้บริการครั้งถัดไปเท่านั้น สำหรับการสมัครใช้บริการแบบผ่อนชำระ ผู้ใช้ยังคงต้องชำระค่าบริการจนครบระยะเวลาผูกมัด ดูรายละเอียดเพิ่มเติมเกี่ยวกับการต่ออายุและการชำระเงินได้ที่ https://developer.android.com/google/play/billing/subscriptions#installments
DEVELOPER_REQUESTED_STOP_PAYMENTS	นักพัฒนาแอปขอยกเลิกและไม่สามารถกู้คืนการสมัครใช้บริการได้ ซึ่งจะหยุดการชําระเงินครั้งถัดไปของการสมัครใช้บริการ สำหรับการสมัครใช้บริการแบบผ่อนชำระ ผู้ใช้จะไม่ต้องชำระเงินครั้งถัดไปและไม่ต้องชําระเงินจนครบระยะเวลาผูกมัด ดูรายละเอียดเพิ่มเติมเกี่ยวกับการต่ออายุและการชําระเงินได้ที่ https://developer.android.com/google/play/billing/subscriptions#installments ลักษณะการทํางานนี้เป็นค่าเริ่มต้นเมื่อไม่ได้ระบุประเภทการยกเลิก