واجهات برمجة التطبيقات للفوترة البديلة

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

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

مسرد المصطلحات

اصطلاحات المصطلحات المتبعة في هذا الدليل:

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

توفير نظام فوترة بديل من خلال ميزة "اختيار المستخدم"

يوضّح هذا القسم طريقة توفير نظام فوترة بديل للمستخدمين مع خيار استخدام نظام الفوترة في Google Play. قبل استخدام واجهات برمجة التطبيقات هذه، تأكّد مما يلي:

بقية الوحدات المقترَحة لدمج خدمة "الفوترة في Google Play" هي نفسها الوحدات التي يستخدمها المطوِّرون حاليًا في عملية الدمج الحالية.

بالإضافة إلى ذلك، ننصحك بتجهيز عملية دمج Google Play Developer API لأن عملية الدمج الخلفية ستستفيد منها.

جارٍ ضبط الإعدادات في Play Console

إنّ المطوِّرين الذين أكملوا التسجيل في برنامج الفوترة البديلة باستخدام اختيار المستخدم المقابل واندمجوا مع واجهات برمجة التطبيقات لنظام الفوترة البديل يمكنهم إدارة إعدادات نظام الفوترة البديل من خلال Play Console:

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

تجربة المستخدم

تتيح واجهات برمجة التطبيقات من جهة العميل الوظائف التالية:

  • يعرض Google Play ويدير المعلومات المعنية وشاشات اختيار المستخدمين
  • إذا اختار المستخدم استخدام نظام الفوترة في Google Play، سيستمر مسار الفوترة في استخدام الواجهة العادية للفوترة في Google Play.

تطبيق مطوّر برامج.

شاشة خيار الفوترة

هذا مثال لأغراض التوضيح فقط.

شاشة اختيار المستخدم

تعرض شاشة اختيار المستخدم للمستخدمين خيار استخدام إما نظام الفوترة البديل الخاص بالمطوّر أو نظام الفوترة في Google Play.

بنية خيار نظام فوترة بديل

يشتمل خيار نظام الفوترة البديل على شاشة اختيار المستخدم على عناصر واجهة المستخدم التالية:

  1. رمز التطبيق
  2. اسم التطبيق.
  3. مادة عرض صورة تتضمّن طرق الدفع التي يقدّمها المطوّر
  4. مؤشر إضافي (والمزيد من عناصر واجهة المستخدم ليس جزءًا من مادة عرض الصورة).

مادة عرض صورة لطرق الدفع

تتألّف مادة عرض الصورة الواحدة من بطاقات طُرق دفع متعدّدة ويجب أن تتّبع المواصفات المحدّدة في هذه الإرشادات.

الأبعاد

192 بكسل مستقل الكثافة X 20 بكسل مستقل الكثافة

تباعُد البطاقات

8 بكسل مستقل الكثافة

تنسيق الملف

صورة PNG بخلفية شفافة

الاختلافات في طريقة الدفع

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

لا يجب تضمين أي صور أو نصوص أخرى في الصورة.

مواصفات البطاقات

يجب أن تتّبع بطاقات طريقة الدفع المضمّنة في مواد عرض الصورة الإرشادات التالية المتعلّقة بالحجم والتباعد والنمط.

أبعاد البطاقة 32 بكسل مستقل الكثافة X 20 بكسل مستقل الكثافة
المساحة المتروكة الداخلية 3dp
المخطّط 1dp (الحد الداخلي مضمَّن في الأبعاد)، نصف القطر 2dp، #E0E0E0
خلفية البطاقة لون خالص (يفضّل أن يكون أبيض)

الخطوات التالية

لبدء دمج واجهات برمجة التطبيقات لنظام الفوترة البديل مع اختيار المستخدم، اتّبِع الأدلة التفصيلية لكل من الدمج داخل التطبيق ودمج الخلفية.

تقديم نظام فوترة بديل فقط

يوضّح هذا القسم كيفية توفير نظام فوترة بديل للمستخدمين بدون اختيار استخدام نظام الفوترة في Google Play. قبل استخدام واجهات برمجة التطبيقات هذه، تأكّد مما يلي:

ننصحك بتجهيز إعداد دمج Google Play Developer API لأن عملية الدمج الخلفية ستستفيد منه.

جارٍ ضبط الإعدادات في Play Console

يمكن للمطوّرين الذين أكملوا عملية التسجيل وتم دمجهم مع واجهات برمجة التطبيقات البديلة لنظام الفوترة البديل إدارة إعدادات نظام الفوترة البديل من خلال Play Console:

  • بالنسبة إلى كل تطبيق من تطبيقاتك المؤهَّلة، يمكنك تفعيل أو إيقاف عرض نظام فوترة بديل فقط (أي بدون خيار المستخدم) في كل بلد يتوفّر فيه.
واجهة مستخدم تجريبية، وهي مخصّصة لأغراض التوضيح، وتخضع للتغيير.

شاشة المعلومات للمستخدمين

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

الخطوات التالية

لبدء دمج واجهات برمجة التطبيقات لنظام الفوترة البديل، اتّبِع الأدلة التفصيلية لكل من التكامل داخل التطبيق ودمج الخلفية.