Method: orders.refund
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
החזר כספי על מינוי או על רכישה מתוך האפליקציה של משתמש. אי אפשר לקבל החזר כספי על הזמנות מלפני 3 שנים ומעלה.
בקשת HTTP
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/orders/{orderId}:refund
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
packageName |
string
שם החבילה של האפליקציה שבה נרכש המינוי או הפריט מתוך האפליקציה (לדוגמה, 'com.some.thing').
|
orderId |
string
מזהה ההזמנה שסופק למשתמש כשנרכש המינוי או ההזמנה מתוך האפליקציה.
|
פרמטרים של שאילתה
| פרמטרים |
revoke |
boolean
האם לבטל את הפריט שנרכש. אם הערך של הפרמטר הזה מוגדר כ-true, הגישה למינוי או לפריט באפליקציה תופסק באופן מיידי. אם הפריט הוא מינוי קבוע, גם כל התשלומים העתידיים יבוטלו. פריטים שנצרכו באפליקציה צריכים להיות מטופלים על ידי האפליקציה של המפתח. (אופציונלי).
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.
דוגמה
דוגמה לבקשה:
curl \
-X POST \
'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.app/orders/1234567890:refund?revoke=true' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer [YOUR_ACCESS_TOKEN]'
היקפי הרשאה
נדרשת הרשאת OAuth ברמה הבאה:
https://www.googleapis.com/auth/androidpublisher
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-06-02 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-06-02 (שעון UTC)."],[[["This operation refunds a user's subscription or in-app purchase order, provided the order is less than 3 years old."],["It uses an HTTP POST request to the specified URL with path parameters for package name and order ID."],["An optional query parameter \"revoke\" can be included to immediately terminate access to the purchased item."],["The request body should be empty, and a successful response will also be empty."],["Authorization requires the `https://www.googleapis.com/auth/androidpublisher` OAuth scope."]]],["This document details how to refund a user's subscription or in-app purchase via a `POST` HTTP request. The request URL requires the application's `packageName` and the `orderId` as path parameters. An optional `revoke` query parameter determines if the purchased item should be immediately revoked. The request body must be empty, and a successful response also returns an empty body. Orders over 3 years old are ineligible for refunds. This action requires the `https://www.googleapis.com/auth/androidpublisher` authorization scope.\n"]]
