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

גרסה עם ערפול קוד (obfuscated) של המזהה שמשויכת באופן ייחודי לחשבון המשתמש באפליקציה שלכם. מוצג רק אם צוין באמצעות 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

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

שיטות

acknowledge

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

consume

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

get

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