Method: purchases.voidedpurchases.list

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

בקשת HTTP

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
packageName

string

שם החבילה של האפליקציה שעבורו צריך להחזיר רכישות מבוטלות (לדוגמה, 'com.some.thing').

פרמטרים של שאילתה

פרמטרים
pageSelection.maxResults

integer (uint32 format)

הגדרת מספר התוצאות שיוחזרו על ידי פעולת הרשימה. מספר ברירת המחדל תלוי באוסף המשאבים.
pageSelection.startIndex

integer (uint32 format)

מגדיר את האינדקס של הרכיב הראשון שיוחזר. ניתן להשתמש באפשרות הזו רק אם החלוקה לדפים שנוספו לאינדקס מופעלת.
pageSelection.token

string

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

string (int64 format)

הזמן, באלפיות השנייה מאז התקופה של תקופת הניסיון, של הרכישה הישנה ביותר שבוטלה שרוצים לראות בתגובה. הערך של הפרמטר הזה לא יכול להיות לפני יותר מ-30 ימים, והמערכת מתעלמת ממנו אם מוגדר אסימון עימוד. ערך ברירת המחדל הוא הזמן הנוכחי פחות 30 יום. הערה: המסנן הזה מיושם בשעה שבה המערכות שלנו נתפסות שהרשומה בוטלה, ולא השעה שבה היא בוטלה בפועל שהוחזרה בתגובה.
endTime

string (int64 format)

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

integer

סוג הרכישות מבוטלות שרוצים לראות בתגובה. הערכים האפשריים הם: 0. רק רכישות של מוצרים מתוך האפליקציה שבוטלו יוחזרו בתגובה. זהו ערך ברירת המחדל. 1. גם רכישות מתוך האפליקציה שבוטלו וגם רכישות מינויים שבוטלו יוחזרו בתגובה.

הערה: לפני שמבקשים לקבל רכישות של מינויים מבוטלים, צריך להשתמש ב- orderId בתשובה שמזהה באופן ייחודי רכישות ומינויים חד-פעמיים. אחרת, יתקבלו מספר הזמנות מינוי עם אותו AssetToken, כי הזמנות לחידוש מינוי חולקות את אותו AssetToken.
includeQuantityBasedPartialRefund

boolean

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

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

תשובה לגבי voidedpurchases.list API.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "pageInfo": {
    object (PageInfo)
  },
  "tokenPagination": {
    object (TokenPagination)
  },
  "voidedPurchases": [
    {
      object (VoidedPurchase)
    }
  ]
}
שדות
pageInfo

object (PageInfo)

מידע כללי על עימוד.
tokenPagination

object (TokenPagination)

פרטי העימוד לצורך עימוד אסימונים.
voidedPurchases[]

object (VoidedPurchase)

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/androidpublisher

PageSelection

סוג הפרמטר של הבקשה pageSelection (בחירת דף) שמגדיר איזה וכמה תוצאות אמורה להחזיר פעולה מסוג voidedpurchases.list.

ייצוג JSON 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
שדות
maxResults

integer (uint32 format)

הגדרת מספר התוצאות שיוחזרו על ידי פעולת הרשימה. מספר ברירת המחדל תלוי באוסף המשאבים.
startIndex

integer (uint32 format)

מגדיר את האינדקס של הרכיב הראשון שיוחזר. ניתן להשתמש באפשרות הזו רק אם החלוקה לדפים שנוספו לאינדקס מופעלת.
token

string

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