- בקשת HTTP
- פרמטרים של הנתיב
- גוף הבקשה
- גוף התגובה
- היקפי הרשאות
- DefiniteTransition
- TentativeTransition
- כדאי לנסות!
לתזמן מעבר בין תוכניות במינוי.
בקשת HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של הנתיב
| פרמטרים | |
|---|---|
packageName |
חובה. החבילה של האפליקציה שבה נרכש המינוי הזה (לדוגמה, "com.some.thing"). |
token |
חובה. האסימון שסופק למכשיר של המשתמש כשהמינוי נרכש. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג ב-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 ( |
| שדות | |
|---|---|
productId |
חובה. המוצר מסוג מינוי (לדוגמה, "premium_plan") שצריך לתזמן את המעבר אליו. |
earliestTransitionEffectiveTime |
חובה. המועד המוקדם ביותר שבו המעבר בין התוכניות יכול להיכנס לתוקף. המעבר בפועל יתבצע במועד החידוש, בתאריך הזה או אחריו. הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
| [חובה] המצב של המעבר בין התוכניות. ברשימה הבאה מפורטים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים: | |
definiteTransition |
כשמשתמשים במצב הזה, המעבר של המשתמש לתוכנית החדשה הוא סופי ואי אפשר לבטל אותו. |
tentativeTransition |
כשמשתמשים במצב הזה, המעבר של המשתמש לתוכנית החדשה הוא זמני ואפשר לבטל אותו. |
| סוף השדות שמוציאים זה את זה. | |
etag |
אם מגדירים את הפרמטר הזה, ה-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 |
פרטי המעבר בין תוכניות של פריט המינוי. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/androidpublisher
DefiniteTransition
בסוג הזה אין שדות.
משמש כדי לציין שהמעבר בין התוכניות הוא סופי.
TentativeTransition
בסוג הזה אין שדות.
משמש לציון שהמעבר בין התוכניות הוא זמני.