REST Resource: purchases.products

משאב: ProductPurchase

משאב ProductPurchase מציין את הסטטוס של רכישת מוצר מתוך האפליקציה של משתמש.

ייצוג ב-JSON 
{
  "kind": string,
  "purchaseTimeMillis": string,
  "purchaseState": integer,
  "consumptionState": integer,
  "developerPayload": string,
  "orderId": string,
  "purchaseType": integer,
  "acknowledgementState": integer,
  "purchaseToken": string,
  "productId": string,
  "quantity": integer,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string,
  "regionCode": string,
  "refundableQuantity": integer
}
שדות
kind

string

הסוג הזה מייצג אובייקט inappPurchase בשירות androidpublisher.
purchaseTimeMillis

string (int64 format)

הזמן שבו המוצר נרכש, במילי-שניות מאז ראשית הזמן (1 בינואר 1970).
purchaseState

integer

מצב הרכישה של ההזמנה. הערכים האפשריים הם: 0. נרכש 1. בוטל 2. בהמתנה
consumptionState

integer

מצב הצריכה של המוצר מתוך האפליקציה. הערכים האפשריים הם: 0. עדיין לא נעשה שימוש ב-1. צריכה
developerPayload

string

מחרוזת שמוגדרת על ידי מפתח ומכילה מידע משלים על הזמנה.
orderId

string

מזהה ההזמנה שמשויך לרכישה של המוצר מתוך האפליקציה.
purchaseType

integer

סוג הרכישה של המוצר בתוך האפליקציה. השדה הזה מוגדר רק אם הרכישה הזו לא בוצעה באמצעות תהליך החיוב הרגיל על רכישות באפליקציות. הערכים האפשריים הם: 0. בדיקה (כלומר, נרכש מחשבון לבדיקת רישיונות) 1. מבצע (כלומר, נרכש באמצעות קוד הטבה). לא כולל רכישות ב-Play Points. 2. מתוגמל (כלומר, מגיע מצפייה במודעת וידאו במקום מתשלום)
acknowledgementState

integer

מצב האישור של המוצר בתוך האפליקציה. הערכים האפשריים הם: 0. עדיין לא אושרה 1. מסירה אושרה
purchaseToken

string

טוקן הרכישה שנוצר כדי לזהות את הרכישה הזו. יכול להיות שהיא לא תופיע.
productId

string

המק"ט של המוצר מתוך האפליקציה. יכול להיות שהיא לא תופיע.
quantity

integer

הכמות שמשויכת לרכישה של המוצר מתוך האפליקציה. אם לא מציינים כמות, כמות ברירת המחדל היא 1.
obfuscatedExternalAccountId

string

גרסה מעורפלת של המזהה שמשויך באופן ייחודי לחשבון של המשתמש באפליקציה. הערך הזה מופיע רק אם הוא צוין באמצעות https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid בזמן ביצוע הרכישה.
obfuscatedExternalProfileId

string

גרסה מעורפלת של המזהה שמשויך באופן ייחודי לפרופיל של המשתמש באפליקציה. הערך הזה מופיע רק אם הוא צוין באמצעות https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid בזמן ביצוע הרכישה.
regionCode

string

קוד אזור החיוב של המשתמש לפי תקן ISO 3166-1 alpha-2 בזמן שהמוצר הוענק.
refundableQuantity

integer

הכמות שעומדת בדרישות לקבלת החזר כספי, כלומר הכמות שלא קיבלה החזר כספי. הערך משקף החזרים כספיים חלקיים שמבוססים על כמות והחזרים כספיים מלאים.

Methods

acknowledge

 מאשר רכישה של פריט מתוך האפליקציה.

consume

 הפונקציה צורכת רכישה של פריט מתוך האפליקציה.

get

 בודק את סטטוס הרכישה והשימוש של פריט בתוך האפליקציה.

קודי שגיאה

הפעולות של המשאב הזה מחזירות את קודי שגיאות ה-HTTP הבאים:

קוד שגיאה סיבה רזולוציה
5xx שגיאה כללית בשרת של Google Play. מנסים לשלוח את הבקשה שוב.

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

היה ניסיון לעדכן אובייקט שנמצא בתהליך עדכון. לדוגמה, רכישה מאושרת על ידי הפעלת המתודה acknowledgePurchase() של Play Billing Library והפעלת המתודה purchases.products.acknowledge של Play Developer API בו-זמנית.

 מנסים לשלוח את הבקשה שוב.