Method: purchases.subscriptionsv2.scheduleplantransition

לתזמן מעבר בין תוכניות במינוי.

בקשת HTTP

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

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

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

פרמטרים
packageName

string

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

token

string

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

גוף הבקשה

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

ייצוג ב-JSON
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
שדות
productId

string

חובה. המוצר מסוג מינוי (לדוגמה, "premium_plan") שצריך לתזמן את המעבר אליו.

earliestTransitionEffectiveTime

string (Timestamp format)

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

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

[חובה] המצב של המעבר בין התוכניות. ברשימה הבאה מפורטים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
definiteTransition

object (DefiniteTransition)

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

tentativeTransition

object (TentativeTransition)

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

סוף השדות שמוציאים זה את זה.
etag

string

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

גוף התשובה

תגובה ל-API‏ purchases.subscriptionsv2.schedulePlanTransition.

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

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

object (PlanTransitionDetails)

פרטי המעבר בין תוכניות של פריט המינוי.

היקפי הרשאות

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

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

DefiniteTransition

בסוג הזה אין שדות.

משמש כדי לציין שהמעבר בין התוכניות הוא סופי.

TentativeTransition

בסוג הזה אין שדות.

משמש לציון שהמעבר בין התוכניות הוא זמני.