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. 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

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