Method: purchases.subscriptions.defer

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

בקשת HTTP

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

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

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

פרמטרים
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)

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