REST Resource: purchases.voidedpurchases
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: Voidedشراء
يشير مورد 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 من واجهة برمجة التطبيقات).
|
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_claimd 3. عيب 4. Accidental_purchase 5- الاحتيال 6. Friendly_fraud 7- رد المبالغ المدفوعة 8. Unacknowledged_purchase
|
voidedQuantity |
integer
الكمية التي تم إلغاؤها بسبب عملية ردّ جزء من الأموال استنادًا إلى الكمية لن يتم إرجاع عمليات الشراء المُلغاة استنادًا إلى الكمية لردّ جزء من الأموال إلا عند ضبطincludeQuantitybasedPartialrefund على "صحيح".
|
الطُرق |
|
|
يسرد عمليات الشراء التي تم إلغاؤها أو ردّ أموالها أو استرداد قيمتها. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eVoidedPurchase\u003c/code\u003e resource represents canceled, refunded, or charged-back purchases in Google Play.\u003c/p\u003e\n"],["\u003cp\u003eIncludes details like purchase time, voided time, reason, and initiator (user, developer, or Google).\u003c/p\u003e\n"],["\u003cp\u003eAccessible via the \u003ccode\u003epurchases.voidedpurchases.list\u003c/code\u003e method to retrieve a list of voided purchases.\u003c/p\u003e\n"],["\u003cp\u003eIdentifies purchases uniquely using \u003ccode\u003epurchaseToken\u003c/code\u003e (for older purchases) or \u003ccode\u003eorderId\u003c/code\u003e (for newer and subscription purchases).\u003c/p\u003e\n"],["\u003cp\u003eProvides \u003ccode\u003evoidedSource\u003c/code\u003e and \u003ccode\u003evoidedReason\u003c/code\u003e fields for understanding the context of the void action.\u003c/p\u003e\n"]]],["The document defines a `VoidedPurchase` resource, representing a canceled, refunded, or charged-back purchase. Key information includes the `purchaseToken`, `purchaseTimeMillis`, `voidedTimeMillis`, and `orderId`. It also specifies the `voidedSource` (user, developer, or Google) and `voidedReason`. `voidedQuantity` indicates the quantity in the case of a partial refund. The method `list` is provided to retrieve lists of these voided purchases. The data is represented in JSON format.\n"],null,["# REST Resource: purchases.voidedpurchases\n\n- [Resource: VoidedPurchase](#VoidedPurchase)\n - [JSON representation](#VoidedPurchase.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: VoidedPurchase\n------------------------\n\nA VoidedPurchase resource indicates a purchase that was either canceled/refunded/charged-back.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"purchaseToken\": string, \"purchaseTimeMillis\": string, \"voidedTimeMillis\": string, \"orderId\": string, \"voidedSource\": integer, \"voidedReason\": integer, \"voidedQuantity\": integer } ``` |\n\n| Fields ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` This kind represents a voided purchase object in the androidpublisher service. |\n| `purchaseToken` | `string` The token which uniquely identifies a one-time purchase or subscription. To uniquely identify subscription renewals use orderId (available starting from version 3 of the API). |\n| `purchaseTimeMillis` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The time at which the purchase was made, in milliseconds since the epoch (Jan 1, 1970). |\n| `voidedTimeMillis` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The time at which the purchase was canceled/refunded/charged-back, in milliseconds since the epoch (Jan 1, 1970). |\n| `orderId` | `string` The order id which uniquely identifies a one-time purchase, subscription purchase, or subscription renewal. |\n| `voidedSource` | `integer` The initiator of voided purchase, possible values are: 0. User 1. Developer 2. Google |\n| `voidedReason` | `integer` The reason why the purchase was voided, possible values are: 0. Other 1. Remorse 2. Not_received 3. Defective 4. Accidental_purchase 5. Fraud 6. Friendly_fraud 7. Chargeback 8. Unacknowledged_purchase |\n| `voidedQuantity` | `integer` The voided quantity as the result of a quantity-based partial refund. Voided purchases of quantity-based partial refunds may only be returned when includeQuantityBasedPartialRefund is set to true. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------|-------------------------------------------------------------------|\n| ### [list](/android-publisher/api-ref/rest/v3/purchases.voidedpurchases/list) | Lists the purchases that were canceled, refunded or charged-back. |"]]
