- משאב: SubscriptionPurchase
- IntroductoryPriceInfo
- SubscriptionCancelSurveyResult
- SubscriptionPriceChange
- שיטות
משאב: SubscriptionPurchase
משאב SubscribePurchase מציין את הסטטוס של רכישת מינוי על ידי משתמש.
ייצוג JSON |
---|
{ "kind": string, "startTimeMillis": string, "expiryTimeMillis": string, "autoResumeTimeMillis": string, "autoRenewing": boolean, "priceCurrencyCode": string, "priceAmountMicros": string, "introductoryPriceInfo": { object ( |
שדות | |
---|---|
kind |
סוג זה מייצג אובייקט subscriptionPurchase בשירות androidpublisher. |
startTimeMillis |
השעה שבה הוענק המינוי, באלפיות השנייה מאז תחילת התקופה. |
expiryTimeMillis |
השעה שבה יפוג תוקף המינוי, באלפיות שנייה מאז Epoch. |
autoResumeTimeMillis |
השעה שבה המינוי יחודש באופן אוטומטי, באלפיות השנייה מאז תחילת התקופה. מוצג רק אם המשתמש ביקש להשהות את המינוי. |
autoRenewing |
האם המינוי יחודש באופן אוטומטי כשיפוג התוקף הנוכחי שלו. |
priceCurrencyCode |
קוד מטבע לפי תקן ISO 4217 של מחיר המינוי. לדוגמה, אם המחיר צוין בלירה שטרלינג בריטית, priceCurrencyCode הוא 'GBP'. |
priceAmountMicros |
מחיר המינוי. במדינות שלא כוללות מס, המחיר לא כולל מס. במדינות שכוללות מיסים, המחיר כולל מס. המחיר מבוטא ביחידות מיקרו, כאשר 1,000,000 מיקרו יחידות מייצגת יחידה אחת של המטבע. לדוגמה, אם מחיר המינוי הוא 1.99€, ה-priceAmountMicros הוא 1990000. |
introductoryPriceInfo |
מידע על מחיר ההיכרות של המינוי. המצב הזה מוצג רק אם המינוי נרכש במחיר היכרות. בשדה הזה לא מצוין שהמינוי נמצא כרגע בתקופת מחיר היכרות. |
countryCode |
קוד המדינה/האזור לחיוב לפי תקן ISO 3166-1 alpha-2 של המשתמש בזמן מתן המינוי. |
developerPayload |
מחרוזת שצוינה על ידי המפתח, שמכילה מידע משלים על הזמנה. |
paymentState |
מצב התשלום של המינוי. הערכים האפשריים הם: 0. תשלום בהמתנה 1. התשלום התקבל 2. תקופת ניסיון בחינם 3. בהמתנה לשדרוג/שדרוג לאחור בהמתנה המאפיין לא קיים למינויים שבוטלו והתוקף שלהם פג. |
cancelReason |
הסיבה לביטול המינוי או לכך שלא מתחדש אוטומטית. הערכים האפשריים הם: 0. המשתמש ביטל את המינוי 1. המינוי בוטל על ידי המערכת, למשל בגלל בעיית חיוב 2. המינוי הוחלף במינוי חדש 3. המינוי בוטל על ידי המפתח |
userCancellationTimeMillis |
השעה שבה המינוי בוטל על ידי המשתמש, באלפיות שנייה מתחילת התקופה. מוצג רק אם הסיבה לביטול היא 0. |
cancelSurveyResult |
מידע שהמשתמש מספק כשהוא משלים את תהליך ביטול המינוי (סקר סיבת הביטול). |
orderId |
מזהה ההזמנה של ההזמנה החוזרת האחרונה שמשויכת לרכישת המינוי. אם המינוי בוטל כי התשלום נדחה, זה יהיה מזהה ההזמנה מהתשלום שנדחתה. |
linkedPurchaseToken |
אסימון הרכישה של הרכישה המקורית אם המינוי הזה הוא אחד מהבאים: 0. הרשמה מחדש של מינוי שבוטל אבל לא בתוקף 1. שדרוג או שדרוג לאחור של מינוי קודם לדוגמה, נניח שמשתמש נרשם במקור וקיבלתם אסימון רכישה X, אז המשתמש מבטל את ההרשמה מחדש ועובר את תהליך ההרשמה מחדש (לפני שפג התוקף של המינוי שלו) וקיבלתם את אסימון הרכישה Y, ולבסוף המשתמש משדרג את המינוי שלו וקיבלתם את אסימון הרכישה ג'. אם תתבצע קריאה ל-API הזה עם אסימון רכישה Z, השדה הזה יוגדר להיות Y. אם תתבצע קריאה ל-API הזה עם אסימון רכישה Y, השדה הזה יוגדר להיות X. אם תתבצע קריאה ל-API הזה עם אסימון רכישה X, השדה הזה לא יוגדר. |
purchaseType |
סוג רכישת המינוי. השדה הזה מוגדר רק אם הרכישה הזו לא בוצעה באמצעות התהליך הרגיל של חיוב על רכישות באפליקציות. הערכים האפשריים הם: 0. בדיקה (כלומר, נרכש מחשבון לבדיקת רישיון) 1. מבצע (כלומר, הפריט נרכש באמצעות קוד הטבה) |
priceChange |
יש מידע עדכני על השינוי במחיר. האפשרות הזו מופיעה רק אם מחיר המינוי ישתנה בקרוב. ברגע שהמינוי יתחדש במחיר החדש או אם המינוי יבוטל, לא יוחזר מידע על שינויים במחיר. |
profileName |
שם הפרופיל של המשתמש בזמן רכישת המינוי. מוצג רק לרכישות שבוצעו באמצעות Subscribe with Google. |
emailAddress |
כתובת האימייל של המשתמש בזמן רכישת המינוי. מוצג רק לרכישות שבוצעו באמצעות Subscribe with Google. |
givenName |
השם הפרטי של המשתמש בזמן רכישת המינוי. מוצג רק לרכישות שבוצעו באמצעות Subscribe with Google. |
familyName |
שם המשפחה של המשתמש בזמן רכישת המינוי. מוצג רק לרכישות שבוצעו באמצעות Subscribe with Google. |
profileId |
מזהה פרופיל Google של המשתמש כשהמינוי נרכש. מוצג רק לרכישות שבוצעו באמצעות Subscribe with Google. |
acknowledgementState |
מצב האישור של מוצר המינוי. הערכים האפשריים הם: 0. עדיין לא אישרנו 1. התקבל אישור |
externalAccountId |
מזהה חשבון המשתמש בשירות הצד השלישי. מוצג רק אם בוצע קישור של החשבון כחלק מתהליך רכישת המינוי. |
promotionType |
סוג המבצע שהוחל על הרכישה הזו. השדה הזה מוגדר רק אם חל מבצע בזמן רכישת המינוי. הערכים האפשריים הם: 0. קוד חד-פעמי 1. קוד שידת איפור |
promotionCode |
קוד השובר שהוחל על הרכישה הזו. השדה הזה מוגדר רק אם חל קידום מכירות עם קוד שם בעת רכישת המינוי. |
obfuscatedExternalAccountId |
גרסה עם ערפול קוד (obfuscated) של המזהה שמשויכת באופן ייחודי לחשבון המשתמש באפליקציה שלכם. הצגה ברכישות הבאות: * אם קישור החשבונות בוצע כחלק מתהליך רכישת המינוי. * הוא צוין באמצעות https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid בזמן ביצוע הרכישה. |
obfuscatedExternalProfileId |
גרסה מעורפלת של המזהה שמשויכת באופן ייחודי לפרופיל המשתמש באפליקציה. יש להציג רק אם צוין באמצעות https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid כאשר הרכישה בוצעה. |
IntroductoryPriceInfo
מידע על מחיר ההיכרות של המינוי.
ייצוג JSON |
---|
{ "introductoryPriceCurrencyCode": string, "introductoryPriceAmountMicros": string, "introductoryPricePeriod": string, "introductoryPriceCycles": integer } |
שדות | |
---|---|
introductoryPriceCurrencyCode |
קוד מטבע ISO 4217 של מחיר מינוי ההיכרות. לדוגמה, אם המחיר צוין בלירה שטרלינג בריטית, priceCurrencyCode הוא 'GBP'. |
introductoryPriceAmountMicros |
מחיר ההיכרות של המינוי, לא כולל מס. המטבע זהה ל-priceCurrencyCode. המחיר מבוטא ביחידות מיקרו, כאשר 1,000,000 מיקרו יחידות מייצגת יחידה אחת של המטבע. לדוגמה, אם מחיר המינוי הוא 1.99€, ה-priceAmountMicros הוא 1990000. |
introductoryPricePeriod |
תקופה של מחיר היכרות, המצוינת בפורמט ISO 8601. הערכים הנפוצים הם (בין היתר) "P1W" (שבוע אחד), "P1M" (חודש אחד), "P3M" (שלושה חודשים), "P6M" (שישה חודשים) ו-P1Y (שנה אחת). |
introductoryPriceCycles |
מספר תקופת החיוב שבה ניתן להציע מחיר היכרות. |
SubscriptionCancelSurveyResult
מידע שהמשתמש מספק כשהוא משלים את תהליך ביטול המינוי (סקר סיבת הביטול).
ייצוג JSON |
---|
{ "cancelSurveyReason": integer, "userInputCancelReason": string } |
שדות | |
---|---|
cancelSurveyReason |
סיבת הביטול שהמשתמש בחר בסקר. הערכים האפשריים הם: 0. אחר 1. השירות הזה לא משמש אותי מספיק 2. בעיות טכניות 3. סיבות שקשורות לעלויות 4. מצאתי אפליקציה טובה יותר |
userInputCancelReason |
סיבת הביטול של הקלט המותאם אישית על ידי המשתמש. מוצג רק כשהסיבה לביטול היא 0. |
SubscriptionPriceChange
מכיל את פרטי השינוי במחיר של מינוי, שיכולים לשמש כדי לשלוט בתהליך שעובר המשתמש עד לשינוי המחיר באפליקציה. הדרך לעשות את זה היא לבקש אישור מהמשתמש או להתאים את החוויה להשגת המרה מוצלחת.
ייצוג JSON |
---|
{
"newPrice": {
object ( |
שדות | |
---|---|
newPrice |
המחיר החדש שבו המינוי יחודש אם המשתמש יאשר את השינוי במחיר. |
state |
המצב הנוכחי של השינוי במחיר. הערכים האפשריים הם: 0. בהמתנה: מצוין אם יש שינוי במחיר בהמתנה לאישור המשתמש. במצב הזה, ניתן לבקש אישור מהמשתמש באמצעות In-App API. 1. אושר: מצוין בהם אם המחיר ישתנה אם המינוי יחודש, אלא אם הוא יבוטל. השינוי במחיר ייכנס לתוקף בתאריך עתידי שבו המינוי יחודש. לתשומת ליבך: יכול להיות שהשינוי לא יתבצע במועד החידוש הבא של המינוי. |
שיטות |
|
---|---|
|
אישור רכישה של מינוי. |
|
מבטל את רכישת המינוי של משתמש. |
|
דחיית רכישת המינוי של המשתמש עד למועד תפוגה עתידי שצוין. |
|
הפונקציה בודקת אם רכישת המינוי של המשתמש תקפה ומחזירה את תאריך התפוגה שלה. |
|
מתבצע החזר כספי על רכישת מינוי של משתמש, אבל המינוי נשאר בתוקף עד למועד התפוגה שלו, והוא ימשיך להתחדש. |
|
קבלת החזר כספי וביטול מיידי של רכישת מינוי של משתמש. |