REST Resource: purchases.voidedpurchases

משאב: VoidedPurchase

משאב VoidedPurchase מציין רכישה שבוטלה, שהתקבל עליה החזר כספי או שהוגש לגביה צ'ארג'בק.

ייצוג ב-JSON 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
שדות
kind

string

הסוג הזה מייצג אובייקט של רכישה שבוטלה בשירות androidpublisher.
purchaseToken

string

הטוקן שמזהה באופן ייחודי רכישה חד-פעמית או מינוי. כדי לזהות באופן ייחודי חידושי מינויים, צריך להשתמש ב-orderId (זמין החל מגרסה 3 של ה-API).
purchaseTimeMillis

string (int64 format)

הזמן שבו בוצעה הרכישה, באלפיות השנייה מאז ראשית זמן יוניקס (1 בינואר 1970).
voidedTimeMillis

string (int64 format)

השעה שבה הרכישה בוטלה/הוחזר עליה כסף/הוגש עליה צ'ארג'בק, במילישניות מאז ראשית זמן יוניקס (1 בינואר 1970).
orderId

string

מזהה ההזמנה שמזהה באופן ייחודי רכישה חד-פעמית, רכישת מינוי או חידוש מינוי.
voidedSource

integer

הגורם שיזם את ביטול הרכישה. הערכים האפשריים הם: 0. משתמש 1. מפתח 2. Google
voidedReason

integer

הסיבה לביטול הרכישה. הערכים האפשריים הם: 0. אחר 1. חרטה 2. Not_received 3. פגום 4. Accidental_purchase 5. הונאה 6. Friendly_fraud 7. החזר כספי בעקבות ביטול עסקה 8. Unacknowledged_purchase
voidedQuantity

integer

הכמות שבוטלה כתוצאה מהחזר כספי חלקי שמבוסס על כמות. אפשר להחזיר רכישות שבוטלו של החזרים כספיים חלקיים שמבוססים על כמות רק אם הערך של includeQuantityBasedPartialRefund מוגדר כ-true.

Methods

list

 רשימת הרכישות שבוטלו, שהוחזר עליהן כסף או שבוצע עליהן צ'ארג'בק.

קודי שגיאה

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

קוד שגיאה סיבה תיאור רזולוציה
400 invalidValue צוין ערך לא תקין בבקשה. השגיאה הזו מוחזרת לעיתים קרובות כשפורמט טוקן הרכישה שגוי או כשהוא לא תקין. מתקנים את הערך הלא תקין של השדה בגוף הבקשה או בפרמטרים על סמך הפניה ל-API.
400 required חסר שדה או פרמטר חובה בבקשה. כדאי לעיין במסמכי התיעוד בנושא API כדי לוודא שכללתם את כל שדות החובה והפרמטרים הנדרשים.
403 userInsufficientPermission למשתמש אין מספיק הרשאות לביצוע הפעולה המבוקשת. מוודאים שלמשתמש המאומת יש את ההרשאות הנדרשות ב-Google Play Console. פרטים נוספים מופיעים במאמר בנושא שימוש בחשבון שירות.
404 notFound לא נמצא המשאב המבוקש. מוודאים שהמזהים (לדוגמה: טוקן רכישה, שם חבילה, מזהה מוצר, מזהה מינוי) נכונים.
409 concurrentUpdate היה ניסיון לעדכן אובייקט שנמצא בתהליך עדכון בו-זמני. מנסים לשלוח שוב את הבקשה עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff). מומלץ להימנע משינויים בו-זמניים באותו משאב.
5xx Generic error שגיאה כללית בשרת של Google Play. צריך לנסות לשלוח את הבקשה שוב.

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