Method: purchases.subscriptions.defer

הוצאה משימוש: במקום זאת, צריך להשתמש ב-purchases.subscriptionsv2.defer. דוחה את רכישת המינוי של המשתמש עד למועד תפוגה עתידי שצוין.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
packageName

string

שם החבילה של האפליקציה שעבורה נרכש המינוי הזה (לדוגמה, com.some.thing).
subscriptionId

string

מזהה המינוי שנרכש (לדוגמה, monthly001).
token

string

האסימון שסופק למכשיר של המשתמש כשנרכש המינוי.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "deferralInfo": {
    object (SubscriptionDeferralInfo)
  }
}
שדות
deferralInfo

object (SubscriptionDeferralInfo)

המידע על מועד התפוגה החדש הרצוי של המינוי.

גוף התשובה

תגובה ל-API‏ purchases.subscriptions.defer.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "newExpiryTimeMillis": string
}
שדות
newExpiryTimeMillis

string (int64 format)

תאריך התפוגה החדש של המינוי באלפיות השנייה מאז ראשית התקופה של זמן מערכת.

דוגמה

דוגמה לבקשה:

curl -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "deferralInfo": {
      "desiredExpiryTimeMillis": "1735689600000",
      "expectedExpiryTimeMillis": "1704067200000"
    }
  }' \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptions/monthly.premium.v1/tokens/aBcDeFgHiJkLmNoPqRsTuVwXyZaBcDeFgHiJkLmNoPqRsTuVwXyZ.1234567890:defer'

זוהי דוגמה לתשובה:

{
  "newExpiryTimeMillis": "1776004800000"
}

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

SubscriptionDeferralInfo

האובייקט SubscriptionDeferralInfo מכיל את הנתונים שנדרשים כדי לדחות רכישת מינוי למועד תפוגה עתידי.

ייצוג ב-JSON 
{
  "expectedExpiryTimeMillis": string,
  "desiredExpiryTimeMillis": string
}
שדות
expectedExpiryTimeMillis

string (int64 format)

מועד התפוגה הצפוי של המינוי. אם מועד התפוגה הנוכחי של המינוי לא זהה לערך שצוין כאן, הדחייה לא תתבצע.
desiredExpiryTimeMillis

string (int64 format)

הזמן הרצוי לתפוגה הבאה שיוקצה למינוי, באלפיות השנייה מאז ראשית התקופה. השעה שצוינה חייבת להיות מאוחרת יותר ממועד התפוגה הנוכחי של המינוי.