Method: purchases.subscriptionsv2.defer

דחיית חידוש המינוי.

בקשת HTTP

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

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

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

פרמטרים
packageName

string

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

token

string

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

גוף הבקשה

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

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

object (DeferralContext)

חובה. פרטים על דחיית המינוי.

גוף התשובה

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

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

ייצוג ב-JSON
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
שדות
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

זמן התפוגה החדש של כל פריט במינוי.

היקפי הרשאות

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

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

DeferralContext

הקשר של הדחייה של purchases.subscriptionsv2.defer API.

ייצוג ב-JSON
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
שדות
etag

string

חובה. ה-API ייכשל אם ה-etag לא תואם ל-etag העדכני של המינוי הזה. ה-etag מאוחזר מ-purchases.subscriptionsv2.get: ‏ https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get

deferDuration

string (Duration format)

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

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-'s'. דוגמה: "3.5s".

validateOnly

boolean

אם הערך הוא true, הבקשה היא הרצה יבשה לאימות ההשפעה של subscriptionsv2.defer, והמינוי לא יושפע.

ItemExpiryTimeDetails

פרטים על זמן התפוגה של פריט מינוי.

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

string

מזהה המוצר של פריט המינוי (לדוגמה, premium_plan).

expiryTime

string (Timestamp format)

תאריך התפוגה החדש של פריט המינוי הזה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z-normalized ויכלול 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".