נתוני הגרסה של ספריית החיובים ב-Google Play

במאמר הזה מפורטים נתוני הגרסאות של ספריית החיובים ב-Google Play.

ספריית החיובים ב-Google Play: גרסה 8.3.0 ‏ (23.12.2025)

גרסה 8.3.0 של Google Play Billing Library ותוספי Kotlin זמינות עכשיו.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 8.2.1 ‏ (15.12.2025)

גרסה 8.2.1 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

תיקוני באגים

ספריית החיובים ב-Google Play: גרסה 8.2.0 ‏ (09.12.2025)

גרסה 8.2.0 של ספריית החיוב של Google Play ותוספי Kotlin זמינות עכשיו.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 8.1.0 ‏ (06.11.2025)

גרסה 8.1.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

  • מינויים מושעים

    נוסף פרמטר חדש לשיטה BillingClient.queryPurchasesAsync() כדי לכלול מינויים מושעים כשמבצעים שאילתה לגבי מינויים. מינויים מושעים עדיין משויכים למשתמש, אבל הם לא פעילים, כי המשתמש השהה את המינוי או שאמצעי התשלום לחידוש המינוי נדחה.

    האובייקט Purchase שמוחזר ב-listener יחזיר את הערך isSuspended() = true לכל המינויים שהושעו. במקרה כזה, לא צריך לתת גישה למינוי שנרכש, אלא להפנות את המשתמש אל מרכז המינויים, שבו הוא יכול לנהל את אמצעי התשלום או להשהות את המינוי כדי להפעיל אותו מחדש.

  • עדכונים במינויים:

    • לאובייקט BillingFlowParams.ProductDetailsParams יש עכשיו את השיטה setSubscriptionProductReplacementParams() שבה אפשר לציין פרטי החלפה ברמת המוצר.

    • לאובייקט SubscriptionProductReplacementParams יש שתי שיטות setter:

      • ‫setOldProductId: המוצר הישן שצריך להחליף אותו במוצר בProductDetails הנוכחי.
      • ‫setReplacementMode: זהו מצב ההחלפה ברמת הפריט. המאפיינים האלה זהים למאפיינים של SubscriptionUpdateParams, אבל מיפוי הערכים עודכן. הוספנו מצב החלפה חדש KEEP_EXISTING שמאפשר לשמור על תזמון התשלומים הקיים ללא שינוי עבור פריט מסוים.

    • השימוש ב-SubscriptionUpdateParams setSubscriptionReplacementMode יופסק. במקומה צריך להשתמש ב-SubscriptionProductReplacementParams.setReplacementMode.

  • העדכון בוצע בתאריך minSdkVersion.

  • הפעלנו ממשקי API להזמנה מראש של מוצרים בחיוב חד-פעמי

    אפשר עכשיו להשתמש ב-ProductDetails.oneTimePurchaseOfferDetails.getPreorderDetails() API שמקבל את פרטי ההזמנה מראש.

  • ספריית החיובים ב-Google Play תומכת עכשיו ב-Kotlin בגרסה 2.2.0.

ספריית החיובים ב-Google Play: גרסה 8.0.0 ‏ (30.06.2025)

גרסה 8.0.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

  • פריטים באפליקציה ייקראו עכשיו מוצרים בחיוב חד-פעמי.

  • אפשרויות רכישה מרובות ומבצעים על מוצרים עם חיוב חד-פעמי.

    עכשיו אפשר להציע כמה אפשרויות רכישה ומבצעים למוצרים בחיוב חד-פעמי. כך תוכלו למכור את המוצרים שלכם בצורה גמישה יותר ולנהל אותם בקלות.

  • שיפרנו את השיטה queryProductDetailsAsync().

    לפני PBL 8.0.0, השיטה queryProductDetailsAsync() לא החזירה מוצרים שלא ניתן היה לאחזר. יכול להיות שהסיבה לכך היא שהמוצר לא נמצא או שאין מבצעים שזמינים למשתמש. בגרסה PBL 8.0.0, מוצרים שלא נשלפו מוחזרים עם קוד סטטוס חדש ברמת המוצר, שמספק מידע על מוצרים שלא נשלפו. שימו לב שבוצע שינוי בחתימה של ProductDetailsResponseListener.onProductDetailsResponse(), ולכן צריך לבצע שינויים באפליקציה. מידע נוסף זמין במאמר בנושא עיבוד התוצאה.

  • חיבור מחדש אוטומטי לשירות.

    הפרמטר החדש BillingClient.Builder.enableAutoServiceReconnection() builder מאפשר למפתחים להצטרף לחיבור מחדש אוטומטי לשירות, שמפשט את ניהול החיבורים על ידי טיפול בחיבורים מחדש לשירות החיוב של Play באופן אוטומטי, ומבטל את הצורך להתקשר אל startConnection() באופן ידני במקרה של ניתוק מהשירות. מידע נוסף זמין במאמר בנושא חידוש אוטומטי של חיבור.

  • קודי תגובה משניים לשיטה launchBillingFlow().

    התשובה BillingResult שמוחזרת מ-launchBillingFlow() תכלול עכשיו שדה של קוד תגובה משני. השדה הזה יאוכלס רק במקרים מסוימים כדי לספק סיבה ספציפית יותר לכישלון. שדה התשובה המשנית יכול לקבל את הערכים הבאים:

    • ‫PAYMENT_DECLINED_DUE_TO_INSUFFICIENT_FUNDS - מוחזר כשסכום הכסף שיש למשתמש קטן ממחיר הפריט שהוא מנסה לקנות.
    • ‫USER_INELIGIBLE – מוחזר אם המשתמש לא עומד בדרישות הסף שנקבעו למינוי.
    • ‫NO_APPLICABLE_SUB_RESPONSE_CODE – ערך ברירת המחדל שמוחזר כשלא חל אף קוד משנה אחר של תגובה.

  • הסרנו את השיטה queryPurchaseHistory().

    השיטה queryPurchaseHistory() שסומנה בעבר כשיטה שהוצאה משימוש הוסרה עכשיו. במאמר שאילתות לגבי היסטוריית הרכישות מפורט אילו ממשקי API חלופיים אפשר להשתמש במקום זאת.

  • הסרנו את השיטה querySkuDetailsAsync().

    השיטה querySkuDetailsAsync(), שסומנה בעבר כפריט שהוצא משימוש, הוסרה עכשיו. במקומה צריך להשתמש ב-queryProductDetailsAsync.

  • הסרנו את השיטה BillingClient.Builder.enablePendingPurchases().

    השיטה enablePendingPurchases() ללא פרמטרים, שסומנה בעבר כפריט שהוצא משימוש, הוסרה עכשיו. במקומה צריך להשתמש ב-enablePendingPurchases(PendingPurchaseParams params). הערה: הפרמטר enablePendingPurchases() שהוצא משימוש זהה מבחינה פונקציונלית לפרמטר enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()).

  • הוסרה שיטת queryPurchasesAsync() שעברה עומס יתר ומקבלת skuType.

    השיטה queryPurchasesAsync(String skuType, PurchasesResponseListener listener) שסומנה בעבר כשיטה שהוצאה משימוש הוסרה עכשיו. אפשר גם להשתמש ב-queryPurchasesAsync(QueryPurchasesParams queryPurchasesParams, PurchasesResponseListener listener).

ספריית החיובים ב-Google Play: גרסה 7.1.1 ‏ (03.10.2024)

גרסה 7.1.1 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

תיקוני באגים

ספריית החיובים ב-Google Play: גרסה 7.1.0 ‏ (19.09.2024)

גרסה 7.1.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

  • שיפור הבטיחות של השרשור שקשור לסטטוס ולניהול החיבור.
  • הוספנו שינויים חלקיים לבדיקה של קודי תגובה BillingResult, שזמינים באופן מלא בספריית החיובים ב-Play בגרסה 7.1.1. כדי לבדוק את השילוב באמצעות התכונה הזו, צריך לשדרג לגרסה 7.1.1 של ספריית החיובים ב-Play. קיים באג שמשפיע רק על אפליקציות שבהן הופעלה בדיקה של חריגות בחיוב, והוא לא משפיע על שימוש רגיל. מידע נוסף זמין במאמר בנושא בדיקת קודי התגובה של BillingResult.

ספריית החיובים ב-Google Play: גרסה 7.0.0 ‏ (14.05.2024)

גרסה 7.0.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 6.2.1 ‏ (16.04.2024)

הגרסה 6.2.1 של ספריית החיובים ב-Google Play והתוספים של Kotlin זמינים עכשיו.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 6.2.0 ‏ (06.03.2024)

גרסה 6.2.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 6.1.0 ‏ (14.11.2023)

גרסה 6.1.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 6.0.1 ‏ (22.06.2023)

גרסה 6.0.1 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

עדכון של ספריית החיובים ב-Play כדי שתהיה תואמת ל-Android 14.

ספריית החיובים ב-Google Play: גרסה 6.0 ‏ (10.05.2023)

גרסה 6.0.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

  • נוסף enum חדש של ReplacementMode כדי להחליף את ProrationMode.

    שימו לב: ProrationMode עדיין זמין מסיבות שקשורות לתאימות לאחור.

  • הוסר מזהה ההזמנה של רכישות PENDING.

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

  • הוסרו השיטות queryPurchases ו-launchPriceConfirmationFlow.

    השיטות queryPurchases ו-launchPriceConfirmationFlow שסומנו בעבר כשיטות שהוצאו משימוש הוסרו עכשיו מ-Play Billing Library 6.0.0. מפתחים צריכים להשתמש ב-queryPurchasesAsync במקום ב-queryPurchases. למידע על חלופות ל-launchPriceConfirmationFlow, אפשר לעיין במאמר שינויים במחירים.

  • נוסף קוד תגובה חדש לשגיאת רשת.

    החל מגרסה 6.0.0 של PBL, נוסף קוד תגובה חדש לשגיאה ברשת: NETWORK_ERROR. הקוד הזה מוחזר כשמתרחשת שגיאה בגלל בעיה בחיבור לרשת. בעבר, שגיאות בחיבור לרשת דווחו כ-SERVICE_UNAVAILABLE.

  • עדכנו את SERVICE_UNAVAILABLE ואת SERVICE_TIMEOUT.

    החל מגרסה 6.0.0 של PBL, שגיאות שנובעות מפסק זמן בעיבוד יוחזרו כ-SERVICE_UNAVAILABLE במקום SERVICE_TIMEOUT הנוכחי.

    ההתנהגות לא משתנה בגרסאות קודמות של PBL.

  • הוסרה SERVICE_TIMEOUT.

    החל מגרסה 6.0.0 של PBL, הערך SERVICE_TIMEOUT לא יוחזר יותר. גרסאות קודמות של PBL עדיין יחזירו את הקוד הזה.

  • נוספה רישום פעולות נוסף.

    גרסה 6 של ספריית החיובים ב-Play כוללת רישום נוסף ביומן, שמספק תובנות לגבי השימוש ב-API (למשל הצלחה וכשל) ובעיות בחיבור לשירות. המידע הזה ישמש לשיפור הביצועים של Play Billing Library ולמתן תמיכה טובה יותר בשגיאות.

ספריית החיובים ב-Google Play: גרסה 5.2.1 ‏ (22.06.2023)

הגרסה 5.2.1 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

עדכון של ספריית החיובים ב-Play כדי שתהיה תואמת ל-Android 14.

ספריית החיובים ב-Google Play: גרסה 5.2 ‏ (06.04.2023)

גרסה 5.2.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 5.1 ‏ (31.10.2022)

גרסה 5.1.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

הגרסה הזו כוללת את השינויים הבאים.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 5.0 ‏ (11.05.2022)

גרסה 5.0.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

הגרסה הזו כוללת את השינויים הבאים.

סיכום השינויים

  • השקנו מודל חדש למינויים, כולל ישויות חדשות שמאפשרות לכם ליצור כמה מבצעים למוצר מינוי יחיד. מידע נוסף זמין במדריך להעברת נתונים.
  • נוסף BillingClient.queryProductDetailsAsync() כדי להחליף את BillingClient.querySkuDetailsAsync().
  • הוספנו את השיטה setIsOfferPersonalized() כדי לעמוד בדרישות הגילוי הנאות בנוגע לתמחור מותאם אישית באיחוד האירופי. מידע נוסף על השימוש בשיטה הזו
  • הוסרה השיטה queryPurchases(), שהוצאה משימוש בעבר והוחלפה בשיטה queryPurchasesAsync שהוצגה בספריית החיובים ב-Google Play 4.0.0.
  • המאפיין launchPriceChangeFlow הוצא משימוש ויוסר בגרסה עתידית. מידע נוסף על חלופות אפשר למצוא במאמר הפעלת תהליך אישור של שינוי מחיר.
  • הוסר setVrPurchaseFlow(), שהיה בשימוש קודם כשיוצרים מופע של תהליך רכישה. בגרסאות קודמות, השיטה הזו הפנתה את המשתמש להשלמת הרכישה במכשיר מבוסס-Android. אחרי שתסירו את השיטה הזו, המשתמשים ישלימו את הרכישה בתהליך הרכישה הרגיל.

ספריית החיובים ב-Google Play: גרסה 4.1 ‏ (23.02.2022)

גרסה 4.1.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

הגרסה הזו כוללת את השינויים הבאים.

סיכום השינויים

  • הוספנו את BillingClient.showInAppMessages() כדי לעזור בטיפול בדחיות של תשלומים על מינויים. כאן אפשר לקרוא מידע נוסף על שימוש בהודעות בתוך האפליקציה לטיפול בדחיות של תשלומים על מינויים.

ספריית החיובים ב-Google Play: גרסה 4.0 ‏ (18.05.2021)

גרסה 4.0.0 של ספריית החיובים ב-Google Play ותוספי Kotlin זמינים עכשיו.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 3.0.3 ‏ (12.03.2021)

גרסה 3.0.3 של ספריית החיובים ב-Google Play, של תוסף Kotlin ושל פלאגין Unity זמינה עכשיו.

תיקוני באגים ב-Java וב-Kotlin

תיקוני באגים ב-Unity

  • עדכון לגרסה 3.0.3 של Java כדי לתקן דליפת זיכרון ולפתור בעיה שמונעת רכישות כשממשיכים להשתמש באפליקציה ממפעיל האפליקציות של Android ודיאלוג החיוב היה גלוי לפני ההשעיה.

ספריית החיובים ב-Google Play: גרסה 3.0.2 ‏ (24.11.2020)

גרסה 3.0.2 של ספריית החיובים ב-Google Play והתוסף Kotlin זמינים עכשיו.

תיקוני באגים

  • תוקן באג בתוסף Kotlin שבו הקורוטינה נכשלת עם השגיאה Already resumed (כבר בוצעה הפעלה מחדש).
  • תוקנו הפניות לא פתורות כשמשתמשים בתוסף Kotlin עם הספרייה kotlinx.coroutines בגרסה 1.4 ומעלה.

ספריית החיובים ב-Google Play: גרסה 3.0.1 ‏ (30.09.2020)

גרסה 3.0.1 של ספריית החיובים ב-Google Play והתוסף Kotlin זמינות עכשיו.

תיקוני באגים

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

ספריית החיובים ב-Google Play: גרסה 3.0 ‏ (08.06.2020)

גרסה 3.0.0 של ספריית החיובים ב-Google Play, של תוסף Kotlin ושל Unity זמינה עכשיו.

סיכום השינויים

  • הוסר התמיכה במק"טים של פרסים.
  • הוסרו הפרמטרים ChildDirected ו-UnderAgeOfConsent.
  • הוסרו שיטות מטען ייעודי למפתח שהוצאו משימוש.
  • הוסרו השיטות שהוצאו משימוש BillingFlowParams.setAccountId() ו-BillingFlowParams.setDeveloperId().
  • הוסרו השיטות שהוצאו משימוש BillingFlowParams.setOldSkus(String oldSku) ו-BillingFlowParams.addOldSku(String oldSku).
  • נוספו הערות לגבי האפשרות שערך יהיה ריק (nullability).

תיקוני באגים

  • ‫SkuDetails.getIntroductoryPriceCycles() מחזירה עכשיו int במקום String.
  • תוקן באג שגרם לכך שזרימת החיוב נחשבה ככזו עם פרמטרים נוספים, גם אם לא הוגדרו פרמטרים נוספים.

ספריית החיובים ב-Google Play: גרסה 2.2.1 ‏ (20.05.2020)

גרסה 2.2.1 של ספריית החיובים ב-Google Play זמינה עכשיו.

תיקוני באגים

  • עדכנו את גרסת ברירת המחדל של ספריית החיובים ב-Java Play שהתוסף Kotlin תלוי בה.

גרסה 2.2.0 של ספריית החיובים ב-Google Play ותמיכה ב-Unity ‏ (23.03.2020)

גרסה 2.2.0 של מערכת החיוב של Google Play מספקת פונקציונליות שעוזרת למפתחים לוודא שהרכישות משויכות למשתמש הנכון. השינויים האלה מייתרים את הצורך בבניית פתרונות בהתאמה אישית שמבוססים על מטען ייעודי (payload) למפתחים. במסגרת העדכון הזה, הוצאנו משימוש את הפונקציונליות של מטען ייעודי (payload) למפתחים, והיא תוסר בגרסה עתידית. מידע נוסף, כולל חלופות מומלצות, זמין במאמר בנושא מטען ייעודי (payload) למפתחים.

ספריית החיובים ב-Google Play, גרסה 2 ל-Unity

בנוסף לגרסאות הנוכחיות של ספריית החיובים ב-Google Play 2 ב-Java וב-Kotlin, פרסמנו גרסה של הספרייה לשימוש עם Unity. מפתחי משחקים שמשתמשים ב-API של Unity לרכישות מתוך האפליקציה יכולים לשדרג עכשיו כדי ליהנות מכל התכונות של ספריית החיובים ב-Google Play גרסה 2, וכדי להקל על השדרוגים הבאים לגרסאות עתידיות של ספריית החיובים ב-Google Play.

מידע נוסף זמין במאמר שימוש בחיוב ב-Google Play עם Unity.

סיכום השינויים

ספריית החיובים ב-Google Play: גרסה 2.1.0 ו-Kotlin Extension: גרסה 2.1.0 ‏ (10.12.2019)

גרסה 2.1.0 של ספריית החיובים ב-Google Play ותוסף Kotlin החדש זמינים עכשיו. התוסף של Kotlin ל-Play Billing Library מספק חלופות ל-API שמתאימות לשימוש ב-Kotlin, עם בטיחות טובה יותר מפני ערכי null ועם coroutines. דוגמאות לקוד זמינות במאמר בנושא שימוש בספריית החיובים ב-Google Play.

הגרסה הזו כוללת את השינויים הבאים.

סיכום השינויים

  • ב-BillingFlowParams, הוצא משימוש setOldSku(String oldSku) והוחלף ב-setOldSku(String oldSku, String purchaseToken), כדי להבחין בין מצבים שבהם כמה חשבונות במכשיר הם הבעלים של אותו מק"ט.

ספריית החיובים ב-Google Play: גרסה 2.0.3 ‏ (05.08.2019)

גרסה 2.0.3 של ספריית החיובים ב-Google Play זמינה עכשיו.

תיקוני באגים

  • תוקן באג שגרם לכך שהפעולה querySkuDetailsAsync() נכשלה מדי פעם עם קוד DEVELOPER_ERROR במקום להחזיר תוצאה מוצלחת.

ספריית החיובים ב-Google Play: גרסה 2.0.2 ‏ (08.07.2019)

גרסה 2.0.2 של ספריית החיובים ב-Google Play זמינה עכשיו. הגרסה הזו כוללת עדכונים במסמכי העיון, ולא משנה את הפונקציונליות של הספרייה.

ספריית החיובים ב-Google Play: גרסה 2.0.1 ‏ (06.06.2019)

גרסה 2.0.1 של ספריית החיובים ב-Google Play זמינה עכשיו. הגרסה הזו כוללת את השינויים הבאים.

תיקוני באגים

  • תוקן באג שגרם לכך שהודעות לגבי ניפוי באגים הוחזרו כ-null במקרים מסוימים.
  • תוקנה בעיה פוטנציאלית של דליפת זיכרון.

ספריית החיובים ב-Google Play: גרסה 2.0 ‏ (07.05.2019)

גרסה 2.0 של ספריית החיובים ב-Google Play זמינה עכשיו. הגרסה הזו כוללת את השינויים הבאים.

צריך לאשר את הרכישות תוך שלושה ימים

ב-Google Play אפשר לרכוש מוצרים מתוך האפליקציה (רכישה מתוך האפליקציה) או מחוץ לאפליקציה (רכישה מחוץ לאפליקציה). כדי שמערכת Google Play תוכל להבטיח חוויית רכישה עקבית בלי קשר למקום שבו המשתמש רוכש את המוצר שלכם, אתם צריכים לאשר את כל הרכישות שמתקבלות דרך ספריית החיובים ב-Google Play בהקדם האפשרי אחרי שאתם מעניקים למשתמש הרשאה. אם לא תאשרו רכישה תוך שלושה ימים, המשתמש יקבל החזר כספי באופן אוטומטי, והרכישה ב-Google Play תבוטל. במקרה של עסקאות בהמתנה (חדש בגרסה 2.0), חלון שלושת הימים מתחיל כשהרכישה עוברת למצב PURCHASED, ולא חל כשהרכישה במצב PENDING.

לגבי מינויים, צריך לאשר כל רכישה שיש לה טוקן רכישה חדש. המשמעות היא שצריך לאשר את כל הרכישות הראשוניות, השינויים בתוכניות וההרשמות מחדש, אבל לא צריך לאשר חידושים עתידיים. כדי לדעת אם צריך לאשר רכישה, אפשר לבדוק את השדה acknowledgement ברכישה.

אובייקט Purchase כולל עכשיו את method‏ isAcknowledged() שמאפשר לדעת אם רכישה אושרה. בנוסף, ב-Google Play Developer API יש ערכים בוליאניים לאישור גם עבור Purchases.products וגם עבור Purchases.subscriptions. לפני שמאשרים רכישה, חשוב להשתמש בשיטות האלה כדי לקבוע אם הרכישה כבר אושרה.

אפשר לאשר רכישה באחת מהשיטות הבאות:

  • לגבי מוצרים מתכלים, משתמשים ב-consumeAsync(), שנמצא ב-API של הלקוח.
  • למוצרים שלא נצרכים, משתמשים ב-acknowledgePurchase(), שנמצא ב-client API.
  • בנוסף, שיטת acknowledge() חדשה זמינה ב-Server API.

השיטה BillingFlowParams.setSku() הוסרה

השיטה BillingFlowParams#setSku() שהוצאה משימוש בעבר הוסרה בגרסה הזו. לפני שמעבדים מוצרים בתהליך רכישה, עכשיו צריך להפעיל את BillingClient.querySkuDetailsAsync() ולהעביר את אובייקט SkuDetails שמתקבל אל BillingFlowParams.Builder.setSkuDetails().

דוגמאות לקוד זמינות במאמר בנושא שימוש בספריית החיובים ב-Google Play.

יש תמיכה במטען ייעודי (payload) למפתחים

בגרסה 2.0 של ספריית החיובים ב-Google Play נוספה תמיכה במטען ייעודי (payload) של מפתחים – מחרוזות שרירותיות שאפשר לצרף לרכישות. אפשר לצרף פרמטר של מטען ייעודי (payload) למפתח לרכישה, אבל רק כשהרכישה מאושרת או כשנעשה בה שימוש. זה שונה ממטען ייעודי (payload) למפתחים ב-AIDL, שבו אפשר לציין את המטען הייעודי כשמפעילים את תהליך הרכישה. עכשיו אפשר להתחיל רכישות מחוץ לאפליקציה, ולכן השינוי הזה מבטיח שתמיד תהיה לכם הזדמנות להוסיף מטען ייעודי (payload) לרכישות.

כדי לגשת למטען הייעודי (payload) בספרייה החדשה, אובייקטים מסוג Purchase כוללים עכשיו את השיטה getDeveloperPayload().

מבצעים עקביים

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

‫SkuDetails כולל שתי שיטות חדשות לאחזור המחיר המקורי של המק"ט:

  • getOriginalPriceAmountMicros()
    • הפונקציה מחזירה את המחיר המקורי של המק"ט לפני הנחה, ללא עיצוב.
  • getOriginalPrice()
    • מחזירה את המחיר המקורי עם עיצוב מטבע נוסף.

עסקאות ממתינות

בגרסה 2.0 של ספריית החיוב ב-Google Play, חובה לתמוך ברכישות שבהן נדרשת פעולה נוספת לפני הענקת זכאות. לדוגמה, משתמש יכול לבחור לרכוש את המוצר שלכם באפליקציה בחנות פיזית באמצעות מזומן. זה אומר שהעסקה הושלמה מחוץ לאפליקציה. בתרחיש הזה, צריך להעניק זכאות רק אחרי שהמשתמש השלים את העסקה.

כדי להפעיל רכישות בהמתנה, צריך לקרוא ל-enablePendingPurchases() כחלק מהאתחול של האפליקציה.

משתמשים ב-Purchase.getPurchaseState() כדי לקבוע אם מצב הרכישה הוא PURCHASED או PENDING. הערה: צריך להעניק זכאות רק כשהסטטוס הוא PURCHASED. כדי לבדוק את סטטוס Purchase, צריך לבצע את הפעולות הבאות:

  1. כשמפעילים את האפליקציה, קוראים ל-BillingClient.queryPurchases() כדי לאחזר את רשימת המוצרים שלא נעשה בהם שימוש שמשויכים למשתמש.
  2. קוראים ל-Purchase.getPurchaseState() בכל אובייקט Purchase שמוחזר.
  3. מטמיעים את ה-method‏ onPurchasesUpdated() כדי להגיב לשינויים באובייקטים מסוג Purchase.

בנוסף, ממשק Google Play Developer API כולל מצב PENDING עבור Purchases.products. אין תמיכה בעסקאות בהמתנה למינויים.

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

כשמאשרים רכישות בהמתנה, חשוב לאשר רק כשהמצב של הרכישה הוא PURCHASED ולא PENDING.

שינויים ב-API

גרסה 2.0 של ספריית החיובים ב-Google Play כוללת כמה שינויים ב-API כדי לתמוך בתכונות חדשות ולשפר את הפונקציונליות הקיימת.

consumeAsync

הפונקציה consumeAsync() מקבלת עכשיו אובייקט ConsumeParams במקום purchaseToken. ‫ConsumeParams מכיל את purchaseToken וגם מטען ייעודי אופציונלי למפתחים.

הגרסה הקודמת של consumeAsync() הוסרה בגרסה הזו.

queryPurchaseHistoryAsync

כדי למנוע בלבול, הפונקציה queryPurchaseHistoryAsync() מחזירה עכשיו אובייקט PurchaseHistoryRecord במקום אובייקט Purchase. אובייקט PurchaseHistoryRecord זהה לאובייקט Purchase, רק שהוא משקף רק את הערכים שמוחזרים על ידי queryPurchaseHistoryAsync() ולא מכיל את השדות autoRenewing, orderId ו-packageName. שימו לב שלא חל שינוי בנתונים שמוחזרים – הפונקציה queryPurchaseHistoryAsync() מחזירה את אותם נתונים כמו קודם.

ערכי ההחזרה של BillingResult

ממשקי API שבעבר החזירו ערך שלם BillingResponse מחזירים עכשיו אובייקט BillingResult. הערך BillingResult מכיל את המספר השלם BillingResponse וגם מחרוזת ניפוי באגים שאפשר להשתמש בה כדי לאבחן שגיאות. מחרוזת הניפוי באגים משתמשת באזור en-US ולא מיועדת להצגה למשתמשי קצה.

תיקוני באגים

ספריית החיובים ב-Google Play: גרסה 1.2.2 ‏ (07.03.2019)

גרסה 1.2.2 של ספריית החיובים ב-Google Play זמינה עכשיו. הגרסה הזו כוללת את השינויים הבאים.

תיקוני באגים

  • תוקנה בעיה בשרשור שהופיעה בגרסה 1.2.1. שיחות ברקע לא חוסמות יותר את ה-thread הראשי.

שינויים אחרים

  • למרות שעדיין מומלץ להשתמש בשרשור הראשי, עכשיו אפשר ליצור מופע של ספריית החיוב של Google Play משרשור ברקע.
  • ההפעלה של אובייקט (Instantiation) הועברה באופן מלא לשרשור ברקע כדי להקטין את הסיכוי לגרום למקרי ANR.

ספריית החיובים ב-Play: גרסה 1.2.1 ‏ (04.03.2019)

גרסה 1.2.1 של ספריית החיובים ב-Google Play זמינה עכשיו. הגרסה הזו כוללת את השינויים הבאים.

שינויים עיקריים

שינויים אחרים

  • נוספו constructors ציבוריים ל-PurchasesResult ול-SkuDetailsResult כדי להקל על הבדיקה.
  • אובייקטים מסוג SkuDetails יכולים להשתמש בשיטה חדשה, getOriginalJson().
  • כל הקריאות לשירות AIDL מטופלות עכשיו על ידי שרשורים ברקע.

תיקוני באגים

  • מאזינים להחזרות (callback) עם ערך null לא מועברים יותר לממשקי API ציבוריים.

ספריית החיובים ב-Google Play: גרסה 1.2 ‏ (18.10.2018)

גרסה 1.2 של ספריית החיובים ב-Google Play זמינה עכשיו. הגרסה הזו כוללת את השינויים הבאים.

סיכום השינויים

  • ספריית החיובים ב-Play מורשית עכשיו במסגרת הסכם הרישיון של ערכת פיתוח התוכנה (SDK) של Android.
  • נוסף API‏ launchPriceChangeConfirmationFlow שמציג למשתמשים בקשה לבדוק שינוי ממתין במחיר המינוי.
  • הוספנו תמיכה במצב חדש של חישוב יחסי, DEFERRED, כשמשדרגים או מורידים את רמת המינוי של משתמש.
  • בקטגוריה BillingFlowParams, מחליפים את setSku() ב-setSkuDetails().
  • תיקוני באגים קלים ואופטימיזציות של קוד.

אישור שינוי מחיר

עכשיו אפשר לשנות את המחיר של מינוי ב-Google Play Console ולבקש מהמשתמשים לבדוק את המחיר החדש ולאשר אותו כשהם נכנסים לאפליקציה.

כדי להשתמש ב-API הזה, צריך ליצור אובייקט PriceChangeFlowParams באמצעות skuDetails של מוצר המינוי, ואז לקרוא ל-launchPriceChangeConfirmationFlow(). מטמיעים את PriceChangeConfirmationListener כדי לטפל בתוצאה כשתהליך האישור של שינוי המחיר מסתיים, כפי שמוצג בקטע הקוד הבא:

Kotlin

val priceChangeFlowParams = PriceChangeFlowParams.newBuilder()
    .setSkuDetails(skuDetailsOfThePriceChangedSubscription)
    .build()

billingClient.launchPriceChangeConfirmationFlow(activity,
        priceChangeFlowParams,
        object : PriceChangeConfirmationListener() {
            override fun onPriceChangeConfirmationResult(responseCode: Int) {
                // Handle the result.
            }
        })

Java

PriceChangeFlowParams priceChangeFlowParams =
        PriceChangeFlowParams.newBuilder()
    .setSkuDetails(skuDetailsOfThePriceChangedSubscription)
    .build();

billingClient.launchPriceChangeConfirmationFlow(activity,
        priceChangeFlowParams,
        new PriceChangeConfirmationListener() {
            @Override
            public void onPriceChangeConfirmationResult(int responseCode) {
                // Handle the result.
            }
        });

בתהליך האישור של שינוי המחיר מוצג דו-שיח עם פרטי התמחור החדשים, והמשתמשים מתבקשים לאשר את המחיר החדש. תהליך העבודה הזה מחזיר קוד תגובה מסוג BillingClient.BillingResponse.

מצב חדש של חישוב יחסי

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

שיטה חדשה להגדרת פרטי מק"ט

בכיתה BillingFlowParams, השיטה setSku() הוצאה משימוש. השינוי הזה נועד לבצע אופטימיזציה של תהליך החיוב ב-Google Play.

כשיוצרים מופע חדש של BillingFlowParams בלקוח של מערכת החיוב מתוך האפליקציה, מומלץ לעבוד ישירות עם אובייקט ה-JSON באמצעות setSkuDetails(), כמו שמוצג בקטע הקוד הבא:

ב-BillingFlowParams Builder class, ה-method‏ setSku() הוצאה משימוש. במקום זאת, משתמשים במתודה setSkuDetails(), כמו שמוצג בקטע הקוד הבא. האובייקט שמועבר לאובייקט setSkuDetails() מגיע מהשיטה querySkuDetailsAsync().

Kotlin

private lateinit var mBillingClient: BillingClient
private val mSkuDetailsMap = HashMap<String, SkuDetails>()

private fun querySkuDetails() {
    val skuDetailsParamsBuilder = SkuDetailsParams.newBuilder()
    mBillingClient.querySkuDetailsAsync(skuDetailsParamsBuilder.build()
    ) { responseCode, skuDetailsList ->
        if (responseCode == 0) {
            for (skuDetails in skuDetailsList) {
                mSkuDetailsMap[skuDetails.sku] = skuDetails
            }
        }
    }
}

private fun startPurchase(skuId: String) {
    val billingFlowParams = BillingFlowParams.newBuilder()
    .setSkuDetails(mSkuDetailsMap[skuId])
    .build()
}

Java

private BillingClient mBillingClient;
private Map<String, SkuDetails> mSkuDetailsMap = new HashMap<>();

private void querySkuDetails() {
    SkuDetailsParams.Builder skuDetailsParamsBuilder
            = SkuDetailsParams.newBuilder();
    mBillingClient.querySkuDetailsAsync(skuDetailsParamsBuilder.build(),
            new SkuDetailsResponseListener() {
                @Override
                public void onSkuDetailsResponse(int responseCode,
                        List<SkuDetails> skuDetailsList) {
                    if (responseCode == 0) {
                        for (SkuDetails skuDetails : skuDetailsList) {
                            mSkuDetailsMap.put(skuDetails.getSku(), skuDetails);
                        }
                    }
                }
            });
}

private void startPurchase(String skuId) {
    BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
            .setSkuDetails(mSkuDetailsMap.get(skuId))
            .build();
}

ספריית החיובים ב-Play: גרסה 1.1 ‏ (07.05.2018)

גרסה 1.1 של ספריית החיובים ב-Google Play זמינה עכשיו. הגרסה הזו כוללת את השינויים הבאים.

סיכום השינויים

  • הוספנו תמיכה בציון מצב חישוב יחסי ב-BillingFlowParams כשמשדרגים או מורידים את רמת המינוי הקיים.
  • הדגל הבוליאני replaceSkusProration ב-BillingFlowParams לא נתמך יותר. במקום זאת, אתם צריכים להשתמש ב-replaceSkusProrationMode.
  • ‫launchBillingFlow() מפעיל עכשיו קריאה חוזרת (callback) לתגובות שנכשלו.

שינויים בהתנהגות

גרסה 1.1 של ספריית החיובים ב-Google Play כוללת את השינויים הבאים בהתנהגות:

מפתחים יכולים להגדיר את replaceSkusProrationMode בכיתה BillingFlowParams

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

Kotlin

BillingFlowParams.newBuilder()
    .setSku(skuId)
    .setType(billingType)
    .setOldSku(oldSku)
    .setReplaceSkusProrationMode(replaceSkusProrationMode)
    .build()

Java

BillingFlowParams.newBuilder()
    .setSku(skuId)
    .setType(billingType)
    .setOldSku(oldSku)
    .setReplaceSkusProrationMode(replaceSkusProrationMode)
    .build();

‫Google Play תומך במצבי החישוב היחסי הבאים:

IMMEDIATE_WITH_TIME_PRORATION ההחלפה נכנסת לתוקף באופן מיידי, וזמן התפוגה החדש יחושב באופן יחסי ויתווסף ליתרת המשתמש או ינוכה ממנה. זו התנהגות ברירת המחדל הנוכחית.
IMMEDIATE_AND_CHARGE_PRORATED_PRICE ההחלפה נכנסת לתוקף באופן מיידי, ומחזור החיובים נשאר זהה. המחיר לתקופה שנותרה יחויב.

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

אין יותר תמיכה ב-replaceSkusProration בכיתה BillingFlowParams

בעבר, מפתחים יכלו להגדיר דגל בוליאני כדי לחייב סכום יחסי על בקשה לשדרוג מינוי. אנחנו תומכים ב-ProrationMode, שמכיל הוראות מפורטות יותר לגבי חישוב יחסי, ולכן אנחנו כבר לא תומכים בדגל הבוליאני הזה.

‫launchBillingFlow() מפעיל עכשיו קריאה חוזרת לתגובות שנכשלו

ספריית החיוב תמיד תפעיל את הקריאה החוזרת (callback) PurhcasesUpdatedListener ותחזיר את BillingResponse באופן אסינכרוני. גם הערך הסינכרוני שמוחזר על ידי BillingResponse נשמר.

תיקוני באגים

  • יציאה מוקדמת נכונה בשיטות אסינכרוניות כשהשירות מנותק.
  • ‫Builder param objects no longer mutates built objects.
  • בעיה 68087141: launchBillingFlow() מעכשיו מופעלת שיחה חוזרת בתגובה לתשובות שנכשלו.

ספריית החיובים ב-Google Play: גרסה 1.0 ‏ (19.09.2017, הודעה)

גרסה 1.0 של ספריית החיובים ב-Google Play זמינה עכשיו. הגרסה הזו כוללת את השינויים הבאים.

שינויים חשובים

  • הרשאת החיוב מוטמעת במניפסט של הספרייה. אין יותר צורך להוסיף את ההרשאה com.android.vending.BILLING במניפסט של Android.
  • נוסף builder חדש למחלקה BillingClient.Builder.
  • הוספנו תבנית builder למחלקה SkuDetailsParams לשימוש בשיטות לשליחת שאילתות לגבי מק"טים.
  • כמה שיטות API עודכנו כדי לשמור על עקביות (אותם שמות וסדר של ארגומנטים להחזרה).

שינויים בהתנהגות

גרסה 1.0 של ספריית החיובים ב-Google Play כוללת את שינויי ההתנהגות הבאים:

המחלקות BillingClient.Builder

‫BillingClient.Builder מאותחל עכשיו באמצעות התבנית newBuilder:

Kotlin

billingClient = BillingClient.newBuilder(context).setListener(this).build()

Java

billingClient = BillingClient.newBuilder(context).setListener(this).build();

השיטה launchBillingFlow נקראת עכשיו באמצעות המחלקה BillingFlowParams

כדי להתחיל את תהליך החיוב של רכישה או מינוי, השיטה launchBillingFlow() מקבלת מופע BillingFlowParams שאותחל עם פרמטרים שספציפיים לבקשה:

Kotlin

BillingFlowParams.newBuilder().setSku(skuId)
        .setType(billingType)
        .setOldSku(oldSku)
        .build()

// Then, use the BillingFlowParams to start the purchase flow
val responseCode = billingClient.launchBillingFlow(builder.build())

Java

BillingFlowParams.newBuilder().setSku(skuId)
                              .setType(billingType)
                              .setOldSku(oldSku)
                              .build();

// Then, use the BillingFlowParams to start the purchase flow
int responseCode = billingClient.launchBillingFlow(builder.build());

דרך חדשה לשאילת שאילתות לגבי מוצרים זמינים

הארגומנטים של השיטות queryPurchaseHistoryAsync() ו-querySkuDetailsAsync() עברו עטיפה בדפוס Builder:

Kotlin

val params = SkuDetailsParams.newBuilder()
params.setSkusList(skuList)
        .setType(itemType)
billingClient.querySkuDetailsAsync(params.build(), object : SkuDetailsResponseListener() {
    ...
})

Java

SkuDetailsParams.Builder params = SkuDetailsParams.newBuilder();
params.setSkusList(skuList)
        .setType(itemType);
billingClient.querySkuDetailsAsync(params.build(), new SkuDetailsResponseListener() {...})

התוצאה מוחזרת עכשיו באמצעות קוד תוצאה ורשימה של אובייקטים SkuDetails, במקום מחלקת wrapper קודמת, כדי שיהיה לכם נוח יותר וכדי לשמור על עקביות ב-API שלנו:

Kotlin

fun onSkuDetailsResponse(@BillingResponse responseCode: Int, skuDetailsList: List<SkuDetails>)

Java

public void onSkuDetailsResponse(@BillingResponse int responseCode, List<SkuDetails> skuDetailsList)

הסדר של הפרמטרים השתנה בשיטה onConsumeResponse()

סדר הארגומנטים של onConsumeResponse בממשק ConsumeResponseListener השתנה כדי ליצור עקביות ב-API שלנו:

Kotlin

fun onConsumeResponse(@BillingResponse responseCode: Int, outToken: String)

Java

public void onConsumeResponse(@BillingResponse int responseCode, String outToken)

אובייקט PurchaseResult לא ארוז

‫PurchaseResult הוסר כדי לשמור על עקביות בכל ממשקי ה-API שלנו:

Kotlin

fun onPurchaseHistoryResponse(@BillingResponse responseCode: Int, purchasesList: List<Purchase>)

Java

void onPurchaseHistoryResponse(@BillingResponse int responseCode, List<Purchase> purchasesList)

תיקוני באגים

גרסה ראשונה של תצוגה מקדימה למפתחים (12 ביוני 2017, הודעה)

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

הספרייה כוללת כמה מחלקות ותכונות נוחות לשימוש כשמשלבים את אפליקציות Android עם Google Play Billing API. הספרייה מספקת גם שכבת הפשטה מעל שירות Android Interface Definition Language ‏ (AIDL), וכך מקלה על מפתחים להגדיר את הממשק בין האפליקציה לבין Google Play Billing API.