נתוני הגרסה של Google Play Developer API

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

‫6 ביולי 2026

תכונות חדשות

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

  • התראות על בקשות להחזר כספי שממתינות לבדיקה: סוג חדש של התראה בזמן אמת למפתחים (RTDN),‏ PendingRefundReviewNotification, נשלח כשמשתמש מבקש החזר כספי על ביטול עסקה שדורש בדיקה מצדכם. הסיבה להחזר כספי שנתמכת בביקורות בהמתנה היא CHARGEBACK בלבד.

  • ‫ReviewRefund API: אתם יכולים לבדוק את הבקשות האלה ולהגיב תוך 24 שעות באמצעות קריאה ל-API החדש ‏orders.reviewrefund. בשיחת ה-API, צריך לציין העדפה להחזר כספי (למשל APPROVE,‏ DECLINE או NEUTRAL) וכל הוכחה רלוונטית לשימוש ברכישה (למשל כתובת ה-IP של המשתמש, אחוז הצריכה המצטבר ומיקום גיאוגרפי כללי) כדי לעזור ל-Google Play לערער על ביטול התשלום.

‫19 במאי 2026

תכונות חדשות

• מזהה הזמנה בהמתנה: SubscriptionPurchaseV2 API כולל עכשיו את השדות onHoldStateContext ו-inGracePeriodStateContext. השדות האלה מספקים פרטים נוספים, כמו מזהה הזמנה בהמתנה או מזהה הזמנה שנכשלה, כשמינוי עובר למצב ON_HOLD או IN_GRACE_PERIOD בגלל תשלום חידוש שנדחה.

הפסקת תמיכה

• חלק מממשקי ה-API של המינויים הוצאו משימוש. מידע נוסף זמין במאמר הוצאה משימוש של Subscription API במאי 2026.

‫27 בינואר 2026

תכונות חדשות

• דחיית חיוב של מינוי עם חבילות: בעבר, ממשק API של Google Play למפתחים אפשר דחיית חיוב רק למינויים בודדים. הפונקציונליות של דחיית תשלום זמינה עכשיו גם למינויים בודדים וגם למינויים עם חבילות, באמצעות ה-method purchases.subscriptionsv2.defer. כשדוחים את תאריך הפקת החשבונית של מינוי עם חבילות, תאריך החיוב של כל הפריטים במינוי נדחה למשך הזמן שצוין.

• ‫OfferPhase: השדה OfferPhase זמין עכשיו ב-SubscriptionPurchaseV2 API. בשדה הזה מופיע השלב הנוכחי של המבצע במינוי, כאחד מהערכים הבאים: תקופה יחסית, תקופת ניסיון בחינם, מחיר היכרות ומחיר המינוי הבסיסי.

‫19 בנובמבר 2025

תכונות חדשות

• טיפול משופר בהרשמה מחדש.

  • השדה outOfAppPurchaseContext זמין עכשיו ב-SubscriptionPurchaseV2. הוא נותן פרטים ממינויים שהתוקף שלהם פג וכך עוזר לקשר את המידע עם רכישות של מינויים חוזרים שבוצעו מחנות Play.
  • ה-method‏ purchases.subscriptions.acknowledge מקבל עכשיו את הפרמטר האופציונלי externalAccountId בגוף הבקשה, שמאפשר לכם לשייך את הרכישה של החידוש למזהי המשתמשים שלכם.

• השדה SubscriptionPurchaseLineItem.itemReplacement זמין עכשיו ב-SubscriptionPurchaseV2. הוא נותן פרטים על הפריט שמוחלף, אם רלוונטי.

• ב-Orders API יש עכשיו את השדה offerPhaseDetails, שמספק מידע מפורט יותר על ההזמנות שמממנות תקופה יחסית.

‫11 בספטמבר 2025

תכונות חדשות

• ‫SubscriptionPurchaseV2 API כולל עכשיו את ה-method cancel.

  ה-method הזה משפר את הפונקציונליות הקיימת של purchases.subscriptions.cancel, כי הוא מוסיף תמיכה בפרמטר cancellationType בספריות הלקוח.

• התכונות של הסכמה להעלאת מחיר זמינות:

  • שדה חדש נוסף ב-SubscriptionPurchaseV2: SubscriptionPurchaseLineItem.auto_renewing_plan.price_step_up_consent_details.

  • סוג חדש של התראה בזמן אמת למפתחים (RTDN) זמין: SUBSCRIPTION_PRICE_STEP_UP_CONSENT_UPDATED.

‫30 ביוני 2025

תכונות חדשות

• ממשק ה-API החדש ProductPurchaseV2, שתומך באפשרויות רכישה מרובות ובמבצעים על מוצרים בחיוב חד-פעמי, זמין עכשיו.

‫21 במאי 2025

הפסקת תמיכה

• חלק מממשקי ה-API של המינויים הוצאו משימוש. מידע נוסף זמין במאמר בנושא הוצאה משימוש של Subscription API.

תכונות חדשות

• השדות החדשים הבאים זמינים ב-SubscriptionPurchaseV2:

  • SubscriptionPurchaseLineItem.latest_successful_order_id
  • PriceChangeState.CANCELED

• ה-method‏ subscriptionsv2.revoke מספק עכשיו את האפשרות item_based_refund.

• ב-Orders API יש עכשיו את ה-methods get ו-batchGet

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

• הפרמטר subscriptionId הוא אופציונלי בממשקי ה-API של purchases.subscriptions.