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

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

string (int64 format)

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

string (int64 format)

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

integer

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

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

boolean

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

نص الطلب

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

نص الاستجابة

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

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

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

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

integer (uint32 format)

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

integer (uint32 format)

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

string

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