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 משתמשת בתחביר של Transcoding של 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

חובה. אם המינוי כולל חבילות שירות, מזהה המוצר של פריט המינוי שרוצים לבטל.