المتطلّبات الأساسية

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

قبل البدء في التكامل مع واجهة برمجة تطبيقات محفظة Google، أكمل الخطوات التالية:

1- الاشتراك في حساب جهة إصدار Google Wallet API

يجب توفّر حساب جهة إصدار البطاقة لإنشاء بطاقات وتوزيعها في "محفظة Google". يمكنك الحصول على حساب جهة الإصدار من خلال الاشتراك في Google Pay ووحدة تحكم المحفظة. بعد الاشتراك، انتقِل إلى صفحة Google Wallet API وانقر على إنشاء أول جواز لك. بعد قبول بنود الخدمة، يمكنك البدء في إنشاء فئة بطاقة.

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

2. التعرُّف على تطوير التطبيقات على نظام Android الأساسي

لتحقيق أغراض هذا البرنامج التعليمي، اطّلع على المفاهيم والمهارات الأساسية لتطوير التطبيقات على نظام Android الأساسي. إذا كنت بحاجة إلى معرفة المزيد عن تطوير Android قبل أن تبدأ، فاستعرض بعض الدروس في تدريب مطوري برامج Android.

3- الحصول على بيانات الاعتماد لتفويض تطبيقك

لاستخدام "واجهة برمجة تطبيقات محفظة Google" لنظام التشغيل Android في تطبيقك المتوافق مع Android بنجاح، يجب مصادقة التطبيق. يمكنك إجراء ذلك باستخدام بصمة الإصبع SHA1 في مفتاح مطوّر البرامج واسم الحزمة.

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

keytool -alias androiddebugkey -keystore path_to_debug_or_production_keystore -list -v

يقع ملف تخزين المفاتيح لتصحيح الأخطاء عادةً في ~/.android/debug.keystore وكلمة مروره هي android.

تطبع أداة Keytool بصمة الإصبع على الهيكل. مثلاً: 

$ keytool -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v
Enter keystore password: Type "android" if using debug.keystore
Alias name: androiddebugkey
Creation date: Aug 27, 2012
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 503bd581
Valid from: Mon Aug 27 13:16:01 PDT 2012 until: Wed Aug 20 13:16:01 PDT 2042
Certificate fingerprints:
   MD5:  1B:2B:2D:37:E1:CE:06:8B:A0:F0:73:05:3C:A3:63:DD
   SHA1: D8:AA:43:97:59:EE:C5:95:26:6A:07:EE:1C:37:8E:F4:F0:C8:05:C8
   SHA256: F3:6F:98:51:9A:DF:C3:15:4E:48:4B:0F:91:E3:3C:6A:A0:97:DC:0A:3F:B2:D2:E1:FE:23:57:F5:EB:AC:13:30
   Signature algorithm name: SHA1withRSA
   Version: 3

انسخ بصمة الإصبع SHA1، التي تم تمييزها في المثال السابق. يجب استخدام بصمة الإصبع واسم حزمة التطبيقات لتفويض التطبيق. ويمكن تفويض التطبيق عن طريق التواصل مع فريق الدعم من خلال أداة دعم جهات الاتصال في Business Console.

4. إعداد خدمات Google Play

إذا لم يكن لديك Android Studio، يمكنك تنزيل Android Studio وتثبيته.

إن محفظة Google لأجهزة Android هي جزء من خدمات Google Play. لاستيراد مكتبات خدمات Google Play، اتبع التعليمات لإعداد خدمات Google Play.

لاستيراد واجهة برمجة تطبيقات "محفظة Google" لنظام التشغيل Android بشكل خاص، أضِف ما يلي إلى جزء التبعيات إلى الملف build.gradle في وحدة التطبيق: 

dependencies {
  implementation 'com.google.android.gms:play-services-pay:16.0.3'
}

5- إنشاء صف لتذاكر

قبل إنشاء بطاقة هدايا وإضافتها، عليك أولاً إنشاء GiftCardClass. ويمكن إجراء ذلك من خلال تسجيل الدخول إلى Google Pay ووحدة التحكّم في المحفظة والانتقال إلى صفحة Google Wallet API وإنشاء GiftCardClass جديد.

  1. تأكد من أنك في علامة التبويب إدارة
  2. من المفترض أن ترى "أنت في الوضع التجريبي" إذا كانت هذه أول مرة تنشئ فيها بطاقة.
  3. في الوضع التجريبي، انقر على "إعداد الحسابات الاختبارية" لإضافة حسابات تجريبية. ستتمكّن هذه الحسابات فقط من حفظ البطاقات عندما يكون حساب جهة الإصدار في الوضع التجريبي.
  4. انقر على إنشاء صف
  5. اختيار بطاقة هدايا
  6. املأ جميع الحقول الإلزامية التي تم وضع علامة * عليها.
  7. انقر على إنشاء صف

كرِّر الخطوات أعلاه إذا كنت تطلب عدة بطاقات هدايا.

الآن بعد أن أنشأت بطاقة GiftCardClass بنجاح، يمكنك الانتقال إلى إضافة بطاقات إلى "محفظة Google".