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 Transcoding.

פרמטרים של נתיב

פרמטרים
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. זוהי התנהגות ברירת המחדל כשלא מצוין סוג ביטול.