قبل استخدام واجهة برمجة تطبيقات محفظة Google للتكامل، أكمل الخطوات التالية:
1- الاشتراك في حساب جهة إصدار Google Wallet API
يجب توفّر حساب جهة إصدار البطاقة لإنشاء بطاقات وتوزيعها في "محفظة Google". يمكنك الاشتراك في Google Pay و"وحدة التحكّم في المحفظة" للحصول على حساب جهة الإصدار. بعد الاشتراك، انتقِل إلى صفحة Google Wallet API وانقر على إنشاء أول بطاقة لك. بعد قبول بنود الخدمة، يمكنك البدء في إنشاء فئة بطاقة.
بعد الخطوة أعلاه، يمكنك أيضًا تجربة الدرس التطبيقي حول الترميز.
2. تفعيل واجهة برمجة تطبيقات المحفظة
- سجِّل الدخول إلى Google Cloud Platform وفعِّل Google Wallet API لمشروع Google Cloud Platform.
- إذا لم يكن لديك مشروع Google Cloud Platform، أنشئ واحدًا.
- تفعيل واجهة برمجة تطبيقات محفظة Google.
3- إنشاء حساب خدمة
يلزم توفر حساب خدمة ومفتاح حساب خدمة للاتصال بواجهة برمجة تطبيقات محفظة Google. حساب الخدمة هو الهوية التي تستدعي واجهة برمجة تطبيقات محفظة Google. يحتوي مفتاح حساب الخدمة على مفتاح خاص يستخدمه تطبيقك للمصادقة على واجهة برمجة تطبيقات محفظة Google.
إنشاء حساب خدمة:
- 1.أنشئ حساب خدمة في Google Cloud Console، مع توفير التفاصيل التالية:
- اسم حساب الخدمة - مثال: عميل ويب على المحفظة
- رقم تعريف حساب الخدمة - مثال: my-service-account
- 2. انقر على إنشاء ومتابعة.
- 3- انقر على تمّ.
إنشاء مفتاح لحساب الخدمة:
- 1- اختَر حساب الخدمة. على سبيل المثال: my-service-account@my-project-id.iam.gserviceaccount.com.
- 2. انقر على عنصر القائمة KEYS في أعلى الصفحة.
- 3- انقر على إضافة مفتاح وإنشاء مفتاح جديد.
- 4. اختَر نوع المفتاح JSON.
- 5- انقر على إنشاء لإنشاء وتنزيل مفتاح حساب الخدمة.
4. تفويض حساب الخدمة
يجب تفويض حساب الخدمة لاستدعاء واجهة برمجة التطبيقات. لاعتماده، امنح حساب الخدمة حق الوصول لإدارة حساب جهة الإصدار.
- انتقِل إلى صفحة المستخدمون في Google Pay ووحدة التحكّم في المحفظة.
- 1- انقر على دعوة مستخدم.
- 2. أضِف عنوان البريد الإلكتروني لحساب الخدمة. على سبيل المثال: my-service-account@my-project-id.iam.gserviceaccount.com.
- 3- اختر مطوّر البرامج لمستوى الوصول.
- 4. انقر على دعوة.
5- إنشاء صف
قبل أن تتمكن من إنشاء GiftCardObject وإضافته، يجب إنشاء GiftCardClass.
لإجراء ذلك، سجِّل الدخول إلى Google Pay ووحدة التحكّم في المحفظة،
وانتقِل إلى صفحة واجهة برمجة تطبيقات محفظة Google وأنشِئ صفًّا جديدًا لبطاقة الهدايا.
- تأكد من أنك في علامة التبويب إدارة
- من المفترض أن ترى "أنت في الوضع التجريبي" إذا كانت هذه أول مرة تنشئ فيها بطاقة.
- في الوضع التجريبي، انقر على "إعداد الحسابات الاختبارية" لإضافة حسابات تجريبية. ستتمكّن هذه الحسابات فقط من حفظ البطاقات عندما يكون حساب جهة الإصدار في الوضع التجريبي.
- انقر على إنشاء صف
- اختيار بطاقة هدايا
- املأ جميع الحقول الإلزامية التي تم وضع علامة * عليها.
- انقر على إنشاء صف
كرِّر الخطوات الواردة في هذه الصفحة إذا كنت بحاجة إلى بطاقات هدايا متعددة.
يمكنك الرجوع إلى نموذج التنسيق للاطّلاع على المزيد من المعلومات حول كيفية تمثيل هذه السمات في البطاقة.
بعد إنشاء فئة بطاقة هدايا بنجاح، يمكنك المتابعة إلى إضافة بطاقات إلى "محفظة Google".