Method: purchases.subscriptions.cancel

ยกเลิกการซื้อการสมัครใช้บริการของผู้ใช้ การสมัครใช้บริการจะยังคงมีผลจนถึงเวลาที่หมดอายุ มีเวอร์ชันใหม่กว่าให้ใช้งานที่ purchases.subscriptionsv2.cancel เพื่อให้รองรับไลบรารีของไคลเอ็นต์ได้ดียิ่งขึ้น

คำขอ 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 แต่จะไม่มีในไลบรารีของไคลเอ็นต์ ผู้ใช้ไลบรารีของไคลเอ็นต์สามารถใช้ purchases.subscriptionsv2.cancel แทนได้

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

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

ตัวอย่าง

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

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 ซึ่งเป็นลักษณะการทำงานเริ่มต้นเมื่อไม่ได้ระบุประเภทการยกเลิก