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. מבצע (כלומר, שנרכש באמצעות קוד הטבה) 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

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

שיטות

acknowledge

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

consume

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

get

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