Method: purchases.voidedpurchases.list

يعرض هذا التقرير عمليات الشراء التي تم إلغاؤها أو ردّ الأموال المدفوعة أو استرداد قيمتها.

طلب HTTP

GET https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/voidedpurchases

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
packageName

string

اسم حزمة التطبيق الذي يجب إرجاع المشتريات الملغاة (على سبيل المثال، "com.some.thing").

معامِلات طلب البحث

المعلّمات
pageSelection.maxResults

integer (uint32 format)

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

integer (uint32 format)

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

string

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

string (int64 format)

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

string (int64 format)

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

integer

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

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

نص الطلب

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

نص الاستجابة

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

الاستجابة لواجهة برمجة التطبيقات إبطال_purchases.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 التي تحدِّد عدد النتائج التي يجب أن تؤدي إلى إبطال عملية الشراء.

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

integer (uint32 format)

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

integer (uint32 format)

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

string

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