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

تحدّد هذه السمة الرمز المميّز للصفحة المطلوب عرضها، وعادةً ما يتم أخذها من TokenPaging Material. لا يمكن استخدام ذلك إلا في حال تفعيل تقسيم الرمز المميّز على عدة صفحات.

startTime

string (int64 format)

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

endTime

string (int64 format)

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

type

integer

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

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

نص الطلب

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

نص الاستجابة

الردّ الخاص بواجهة برمجة التطبيقات voidedpurchases.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 التي تحدِّد النتيجة التي يجب أن تعرضها عملية voidedpurchases.list وعدد النتائج التي يجب أن تعرضها.

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

integer (uint32 format)

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

startIndex

integer (uint32 format)

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

token

string

تحدّد هذه السمة الرمز المميّز للصفحة المطلوب عرضها، وعادةً ما يتم أخذها من TokenPaging Material. لا يمكن استخدام ذلك إلا في حال تفعيل تقسيم الرمز المميّز على عدة صفحات.