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 הבאים:

קוד שגיאה סיבה תיאור רזולוציה