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

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

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

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

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

גרסה 8.1.0 של ספריית החיובים ב-Google Play ‏ (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.

גרסה 8.0.0 של ספריית החיובים ב-Google Play (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() תכלול עכשיו שדה של קוד תגובה משני. השדה הזה יאוכלס רק במקרים מסוימים כדי לספק סיבה ספציפית יותר לכשל. ב-PBL 8.0.0, קוד המשנה PAYMENT_DECLINED_DUE_TO_INSUFFICIENT_FUNDS מוחזר במקרה שבו הסכום בחשבון של המשתמש נמוך ממחיר הפריט שהוא מנסה לרכוש.

  • הסרנו את השיטה 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).

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

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

תיקוני באגים

גרסה 7.1.0 של ספריית החיובים ב-Google Play (19 בספטמבר 2024)

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

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

  • שיפור הבטיחות של השרשור שקשור לסטטוס ולניהול החיבור.
  • הוספנו שינויים חלקיים לבדיקה [BillingResult][billing-result] של קודי תגובה, שזמינים באופן מלא בספריית החיובים ב-Play בגרסה 7.1.1. כדי לבדוק את השילוב באמצעות התכונה הזו, צריך לשדרג לגרסה 7.1.1 של ספריית החיובים ב-Play. קיים באג שמשפיע רק על אפליקציות שבהן [הופעלה בדיקה של שינויים בחיוב][enable-billing-overrides-testing], והוא לא משפיע על שימוש רגיל. מידע נוסף זמין במאמר בנושא בדיקת קודי התגובה של BillingResult. ‫[billing-result]: /reference/com/android/billingclient/api/BillingResult ‫[enable-billing-overrides-testing]: /google/play/billing/test-response-codes#enable-billing-overrides-testing

גרסה 7.0.0 של ספריית החיובים ב-Google Play (14 במאי 2024)

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

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

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

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

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

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

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

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

גרסה 6.1.0 של ספריית החיובים ב-Google Play (14 בנובמבר 2023)

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

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

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

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

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

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

גרסה 6.0 של ספריית החיובים ב-Google Play ‏ (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 של ספריית החיובים ב-Play, נוסף קוד תגובה חדש לשגיאה בחיבור לרשת, 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 ולמתן תמיכה טובה יותר בשגיאות.

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

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

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

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

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

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

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

גרסה 5.1 של ספריית החיובים ב-Google Play (31 באוקטובר 2022)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

תיקוני באגים

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

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

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

תיקוני באגים

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

השקת גרסה 3.0 של ספריית החיובים ב-Google Play‏ (2020-06-08)

גרסה 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.
  • תוקן באג שגרם לכך שתהליך החיוב נחשב כבעל פרמטרים נוספים, גם אם לא הוגדרו פרמטרים נוספים.

גרסה 2.2.1 של ספריית החיובים ב-Google Play‏ (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.

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

השקת גרסה 2.1.0 של ספריית החיובים ב-Google Play והשקת גרסה 2.1.0 של Kotlin Extension‏ (10 בדצמבר 2019)

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

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

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

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

גרסה 2.0.3 של ספריית החיובים ב-Google Play (05-08-2019)

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

תיקוני באגים

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

גרסה 2.0.2 של ספריית החיובים ב-Google Play (2019-07-08)

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

גרסה 2.0.1 של ספריית החיובים ב-Google Play (2019-06-06)

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

תיקוני באגים

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

השקת ספריית החיובים ב-Google Play בגרסה 2.0 (2019-05-07)

גרסה 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. מטמיעים את השיטה 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 ולא מיועדת להצגה למשתמשי קצה.

תיקוני באגים

גרסה 1.2.2 של ספריית החיובים ב-Google Play (07-03-2019)

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

תיקוני באגים

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

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

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

גרסה 1.2.1 של ספריית החיובים ב-Play (04-03-2019)

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

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

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

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

תיקוני באגים

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

גרסה 1.2 של ספריית החיובים ב-Google Play (18 באוקטובר 2018)

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

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

  • ספריית החיובים ב-Google 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(), כמו שמוצג בקטע הקוד הבא:

במחלקת ה-Builder, השיטה setSku() הוצאה משימוש.BillingFlowParams במקום זאת, צריך להשתמש במתודה 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();
}

גרסה 1.1 של ספריית החיובים ב-Play (2018-05-07)

גרסה 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.
  • נוסף כלי חדש ליצירת קהלים למחלקה 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‏ (AIDL), וכך מקלה על מפתחים להגדיר את הממשק בין האפליקציה לבין Google Play Billing API.