Method: orders.reviewrefund

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

בקשת HTTP

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:reviewrefund

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
packageName

string

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

string

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "pendingRefundToken": string,
  "sampleContentProvided": boolean,
  "refundPreference": enum (RefundPreference),
  "consumptionPercentageMilliunits": integer,
  "consumptionUsageEvents": [
    {
      object (ConsumptionUsageEvent)
    }
  ]
}
שדות
pendingRefundToken

string

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

boolean

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

enum (RefundPreference)

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

integer

אופציונלי. אחוז הרכישה מתוך האפליקציה שהלקוח ניצל, באלפיות יחידה. מינימום: 0, מקסימום: 100,000. באפליקציות בתשלום, אפשר לדלג על השלב הזה. דוגמה : הערך 45200 מייצג 45.2%.
consumptionUsageEvents[]

object (ConsumptionUsageEvent)

אופציונלי. רשימת אירועים, שכל אחד מהם מייצג מופע שבו המשתמש צרך או השתמש בפריט או בשירות שנרכשו. רשימות עם יותר מ-1,000 פריטים יידחו.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.

היקפי הרשאות

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

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

RefundPreference

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

טיפוסים בני מנייה (enum)
REFUND_PREFERENCE_UNSPECIFIED לא צוינה העדפה לגבי החזרים כספיים על הזמנות. הערך הזה לא נמצא בשימוש.
DECLINE המפתח מעדיף ש-Play ידחה את ההחזר הכספי.
APPROVE המפתח מעדיף ש-Play יאשר את ההחזר הכספי המלא.
NEUTRAL למפתח אין העדפה לגבי ההחלטה של Google Play להנפיק החזר כספי

ConsumptionUsageEvent

רשימת אירועים, שכל אחד מהם מייצג מופע שבו המשתמש צרך או השתמש בפריט או בשירות שנרכשו.

ייצוג JSON 
{
  "obfuscatedAccountId": string,
  "obfuscatedProfileId": string,
  "consumptionTime": string,
  "ipAddress": string,
  "consumptionItemDescription": string,
  "location": {
    object (CoarseLocation)
  }
}
שדות
obfuscatedAccountId

string

אופציונלי. מחרוזת מעורפלת שמשויכת באופן ייחודי לחשבון המשתמש של הרוכש באפליקציה. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedAccountId(java.lang.String)
obfuscatedProfileId

string

אופציונלי. מחרוזת שעברה טשטוש ומשויכת באופן ייחודי לפרופיל המשתמש של הרוכש באפליקציה. https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setObfuscatedProfileId(java.lang.String)
consumptionTime

string (Timestamp format)

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

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
ipAddress

string

אופציונלי. כתובת ה-IP שממנה התרחשה הצריכה.
consumptionItemDescription

string

אופציונלי. טקסט חופשי שמאפשר למפתחים לספק מידע נוסף על הפריט שנצרך. האורך המרבי הוא 5,000 תווים.
location

object (CoarseLocation)

אופציונלי. המיקום הגיאוגרפי שבו התרחשה הצריכה.

CoarseLocation

פרטים על המיקום הגיאוגרפי המשוער שבו התרחשה הצריכה.

ייצוג JSON 
{
  "regionCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string
}
שדות
regionCode

string

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

string

אופציונלי. הרמה המנהלית שמעל לרשות המוניציפאלית שמשמשת לכתובות למשלוח דואר במדינה או באזור. לדוגמה, מדינה, מחוז, אזור או תחום שיפוט. בספרד, צריך לציין את המחוז ולא את הקהילה האוטונומית (לדוגמה, 'ברצלונה' ולא 'קטלוניה'). במדינות רבות לא משתמשים באזור אדמיניסטרטיבי בכתובות למשלוח דואר. לדוגמה, בשווייץ לא צריך להזין ערך.
locality

string

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

string

אופציונלי. האזור המשני שמוגדר בכתובת. לדוגמה, שכונה, רובע או מחוז. ברוב הכתובות, אפשר להשמיט את זה.