- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- PageSelection
- جرِّبه الآن
يعرض عمليات الشراء التي تم إلغاؤها أو ردّ أموالها أو استرداد أموالها.
طلب HTTP
GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
packageName |
اسم حزمة التطبيق الذي يجب إعادة عمليات الشراء المُلغاة له (على سبيل المثال، "com.some.thing"). |
معلمات طلب البحث
المَعلمات | |
---|---|
pageSelection.maxResults |
تحدد عدد النتائج التي يجب أن تعرضها عملية القائمة. ويعتمد الرقم التلقائي على مجموعة الموارد. |
pageSelection.startIndex |
تحدد فهرس العنصر الأول المطلوب عرضه. لا يمكن استخدام ذلك إلا في حال تفعيل خيار نقل الصفحات المفهرسة. |
pageSelection.token |
تحدد الرمز المميز للصفحة المراد إرجاعها، والتي عادة ما يتم أخذها من TokenPpageation. ولا يمكن استخدام ذلك إلا في حال تفعيل التقسيم على صفحات الرموز المميزة. |
startTime |
الوقت بالمللي ثانية منذ تاريخ بدء عملية الشراء الأقدم التي تريد عرضها في الردّ. لا يمكن أن تكون قيمة هذه المَعلمة أقدم من 30 يومًا، ويتم تجاهلها في حال ضبط رمز مميّز للتقسيم على صفحات. القيمة التلقائية هي الوقت الحالي مطروحًا منه 30 يومًا. ملاحظة: يتم تطبيق هذا الفلتر على الوقت الذي تكون فيه أنظمتنا ملغية في السجلّ، وليس حسب الوقت الفعلي الذي تم إبطاله في الردّ. |
endTime |
الوقت بالمللي ثانية منذ تاريخ بدء عملية الشراء الأخيرة المُلغاة والتي تريد الردّ عليها. لا يمكن أن تكون قيمة هذه المَعلمة أكبر من الوقت الحالي، ويتم تجاهلها في حال ضبط رمز مميَّز للتقسيم على صفحات. القيمة التلقائية هي الوقت الحالي. ملاحظة: يتم تطبيق هذا الفلتر على الوقت الذي تكون فيه أنظمتنا ملغية في السجلّ، وليس حسب الوقت الفعلي الذي تم إبطاله في الردّ. |
type |
نوع عمليات الشراء المُلغاة والتي تريد أن تظهر في الردّ. القيم المتاحة هي: 0. ولن يتم عرض سوى عمليات شراء المنتجات داخل التطبيق التي تم إلغاؤها. هذه هي القيمة الافتراضية. 1- سيصلك في الردّ كل عمليات الشراء التي تم إلغاؤها داخل التطبيق وعمليات شراء الاشتراكات المُلغاة. ملاحظة: قبل طلب تلقّي عمليات شراء اشتراكات تم إلغاؤها، يجب التبديل إلى استخدام orderId في الردّ الذي يحدّد بشكل فريد عمليات الشراء لمرة واحدة والاشتراكات. وبخلاف ذلك، ستصلك طلبات اشتراك متعددة باستخدام رمز purchaseToken نفسه، لأنّ طلبات تجديد الاشتراك تشترك في رمز purchaseToken نفسه. |
includeQuantityBasedPartialRefund |
اختياريّ. لتحديد ما إذا كان سيتم تضمين عمليات شراء مُلغاة استنادًا إلى الكمية لاسترداد جزء من الأموال، والتي تسري فقط على عمليات الشراء التي تتضمّن عدّة كمية في حال ضبط هذه السياسة على "صحيح"، قد يتم إرجاع عمليات الشراء الإضافية المُلغاة مع تحديد قيمة mutedQuantity للإشارة إلى كمية عمليات ردّ الأموال الجزئية المستندة إلى الكمية. القيمة التلقائية هي false. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
استجابة واجهة برمجة التطبيقات mutedpurchases.list.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "pageInfo": { object ( |
الحقول | |
---|---|
pageInfo |
المعلومات العامة حول تقسيم النتائج على عدّة صفحات |
tokenPagination |
معلومات تقسيم النتائج على عدّة صفحات للرمز المميّز |
voidedPurchases[] |
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidpublisher
PageSelection
نوع معلَمة طلب pageSelection التي تحدّد النتائج وعدد النتائج التي يجب أن تعرضها عملية mutedpurchases.list.
تمثيل JSON |
---|
{ "maxResults": integer, "startIndex": integer, "token": string } |
الحقول | |
---|---|
maxResults |
تحدد عدد النتائج التي يجب أن تعرضها عملية القائمة. ويعتمد الرقم التلقائي على مجموعة الموارد. |
startIndex |
تحدد فهرس العنصر الأول المطلوب عرضه. لا يمكن استخدام ذلك إلا في حال تفعيل خيار نقل الصفحات المفهرسة. |
token |
تحدد الرمز المميز للصفحة المراد إرجاعها، والتي عادة ما يتم أخذها من TokenPpageation. ولا يمكن استخدام ذلك إلا في حال تفعيل التقسيم على صفحات الرموز المميزة. |