واجهة برمجة التطبيقات لعمليات الشراء التي تم إلغاؤها

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

توفّر واجهة برمجة التطبيقات Google Play Voided Buys قائمة بالطلبات المرتبطة بعمليات الشراء التي ألغاها المستخدم. ويمكنك استخدام معلومات من هذه القائمة لتنفيذ نظام إبطال يمنع المستخدم من الوصول إلى المنتجات من هذه الطلبات.

وتنطبق واجهة برمجة التطبيقات هذه على الطلبات داخل التطبيق واشتراكات التطبيقات لمرة واحدة.

يمكن إلغاء عملية الشراء بالطرق التالية:

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

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

الحصول على إمكانية الوصول

للتعامل مع واجهة برمجة التطبيقات لعمليات الشراء المُلغاة، يجب الحصول على إذن للاطّلاع على المعلومات المالية. يتم توفير التفويض باستخدام برنامج OAuth أو حساب الخدمة. إذا كنت تستخدم حساب خدمة، فعِّل الإذن "&& عرض&؛عرض التقارير المالية" في هذا الحساب.

لمعرفة المزيد من المعلومات عن الحصول على إمكانية وصول معتمد إلى واجهات برمجة التطبيقات Google Play Developer API، يُرجى الاطّلاع على الأدلة التالية:

عرض عمليات الشراء التي تم إلغاؤها

استخدِم الطريقة GET لطلب قائمة بعمليات شراء باطلة. في طلبك، عليك تضمين اسم الحزمة المؤهلة بالكامل لتطبيقك، مثل com.google.android.apps.maps، والرمز المميز للتفويض الذي تلقّيته عند الحصول على إمكانية الوصول إلى واجهة برمجة التطبيقات.

GET https://www.googleapis.com/androidpublisher/v3/applications/
your_package_name/purchases/voidedpurchases?access_token=your_auth_token

يمكنك أيضًا تضمين المعلمات التالية في طلبك، كل معلّمة اختيارية:

وقت البدء

الوقت بالملي ثانية منذ عصر Unix، من أول عملية شراء مُلغاة يتم عرضها في الرد. بشكل تلقائي، يتم ضبط startTime على 30 يومًا.

ولا يمكن أن تعرض واجهة برمجة التطبيقات سوى عمليات الشراء التي تم إلغاؤها خلال آخر 30 يومًا. لا يتم تضمين عمليات الشراء القديمة التي تم إبطالها في الاستجابة، بغض النظر عن القيمة التي قدمتها إلى startTime.

وقت الانتهاء

الوقت بالمللي ثانية منذ عصر Unix، لآخر عملية شراء باطلة تم إبطالها وتريد عرضها في الاستجابة ويتم ضبط endTime على الوقت الحالي تلقائيًا.

الحد الأقصى للنتائج
الحد الأقصى لعدد عمليات الشراء الملغاة التي تظهر في كل استجابة. وتكون هذه القيمة 1, 000 تلقائيًا. يُرجى العلم بأن الحد الأقصى لقيمة هذه المعلّمة هو 1000 أيضًا.
رمز مميّز
رمز مميز للمتابعة من استجابة سابقة يتيح لك عرض المزيد من النتائج.
كتابة

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

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

{
  "tokenPagination": {
    "nextPageToken": "next_page_token"
  },
  "voidedPurchases": [
    {
      "kind": "androidpublisher#voidedPurchase",
      "purchaseToken": "some_purchase_token",
      "purchaseTimeMillis": "1468825200000",
      "voidedTimeMillis": "1469430000000",
      "orderId": "some_order_id",
      "voidedSource": "0",
      "voidedReason": "4"
    },
    {
      "kind": "androidpublisher#voidedPurchase",
      "purchaseToken": "some_other_purchase_token",
      "purchaseTimeMillis": "1468825100000",
      "voidedTimeMillis": "1470034800000",
      "orderId": "some_other_order_id",
      "voidedSource": "2",
      "voidedReason": "5"
    },
  ]
}

الحصص

تعيّن واجهة برمجة التطبيقات لعمليات الشراء المُلغاة الحصص التالية على أساس كل حزمة:

  • 6000 طلب في اليوم. (يبدأ اليوم وينتهي في منتصف الليل بتوقيت المحيط الهادئ.)
  • 30 طلبًا خلال أي فترة مدتها 30 ثانية.

إرشادات الطلبات الأولية

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

  • استخدِم القيمة التلقائية للمَعلمة maxResults. وبهذه الطريقة، إذا استخدمت حصة طلبات البحث بأكملها في يوم واحد، يمكنك استرداد تفاصيل 6,000,000 عملية شراء تم إلغاؤها.
  • إذا تضمّنت الاستجابة قيمة nextPageToken، يمكنك تخصيص هذه القيمة إلى المعلَمة token أثناء طلبك التالي.

أفضل الممارسات

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

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