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

تحدد الرمز المميز للصفحة المراد إرجاعها، والتي عادة ما يتم أخذها من TokenPpageation. ولا يمكن استخدام ذلك إلا في حال تفعيل التقسيم على صفحات الرموز المميزة.
startTime

string (int64 format)

الوقت بالمللي ثانية منذ تاريخ بدء عملية الشراء الأقدم التي تريد عرضها في الردّ. لا يمكن أن تكون قيمة هذه المَعلمة أقدم من 30 يومًا، ويتم تجاهلها في حال ضبط رمز مميّز للتقسيم على صفحات. القيمة التلقائية هي الوقت الحالي مطروحًا منه 30 يومًا. ملاحظة: يتم تطبيق هذا الفلتر على الوقت الذي تكون فيه أنظمتنا ملغية في السجلّ، وليس حسب الوقت الفعلي الذي تم إبطاله في الردّ.
endTime

string (int64 format)

الوقت بالمللي ثانية منذ تاريخ بدء عملية الشراء الأخيرة المُلغاة والتي تريد الردّ عليها. لا يمكن أن تكون قيمة هذه المَعلمة أكبر من الوقت الحالي، ويتم تجاهلها في حال ضبط رمز مميَّز للتقسيم على صفحات. القيمة التلقائية هي الوقت الحالي. ملاحظة: يتم تطبيق هذا الفلتر على الوقت الذي تكون فيه أنظمتنا ملغية في السجلّ، وليس حسب الوقت الفعلي الذي تم إبطاله في الردّ.
type

integer

نوع عمليات الشراء المُلغاة والتي تريد أن تظهر في الردّ. القيم المتاحة هي: 0. ولن يتم عرض سوى عمليات شراء المنتجات داخل التطبيق التي تم إلغاؤها. هذه هي القيمة الافتراضية. 1- سيصلك في الردّ كل عمليات الشراء التي تم إلغاؤها داخل التطبيق وعمليات شراء الاشتراكات المُلغاة.

ملاحظة: قبل طلب تلقّي عمليات شراء اشتراكات تم إلغاؤها، يجب التبديل إلى استخدام orderId في الردّ الذي يحدّد بشكل فريد عمليات الشراء لمرة واحدة والاشتراكات. وبخلاف ذلك، ستصلك طلبات اشتراك متعددة باستخدام رمز purchaseToken نفسه، لأنّ طلبات تجديد الاشتراك تشترك في رمز purchaseToken نفسه.
includeQuantityBasedPartialRefund

boolean

اختياريّ. لتحديد ما إذا كان سيتم تضمين عمليات شراء مُلغاة استنادًا إلى الكمية لاسترداد جزء من الأموال، والتي تسري فقط على عمليات الشراء التي تتضمّن عدّة كمية في حال ضبط هذه السياسة على "صحيح"، قد يتم إرجاع عمليات الشراء الإضافية المُلغاة مع تحديد قيمة mutedQuantity للإشارة إلى كمية عمليات ردّ الأموال الجزئية المستندة إلى الكمية. القيمة التلقائية هي false.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

استجابة واجهة برمجة التطبيقات mutedpurchases.list.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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 التي تحدّد النتائج وعدد النتائج التي يجب أن تعرضها عملية mutedpurchases.list.

تمثيل JSON 
{
  "maxResults": integer,
  "startIndex": integer,
  "token": string
}
الحقول
maxResults

integer (uint32 format)

تحدد عدد النتائج التي يجب أن تعرضها عملية القائمة. ويعتمد الرقم التلقائي على مجموعة الموارد.
startIndex

integer (uint32 format)

تحدد فهرس العنصر الأول المطلوب عرضه. لا يمكن استخدام ذلك إلا في حال تفعيل خيار نقل الصفحات المفهرسة.
token

string

تحدد الرمز المميز للصفحة المراد إرجاعها، والتي عادة ما يتم أخذها من TokenPpageation. ولا يمكن استخدام ذلك إلا في حال تفعيل التقسيم على صفحات الرموز المميزة.