توفّر "محفظة Google" واجهة برمجة تطبيقات REST تتيح لك إنشاء البطاقات وإدارتها من خلال إرسال الطلبات إلى Google Wallet API عبر HTTP. وهذا مفيد لأولئك الذين يريدون إنشاء خدمات من جهة الخادم للعمل على البطاقات آليًا.
لاستخدام Google Wallet REST API، عليك تفعيل واجهة برمجة التطبيقات في Google Cloud Console وإنشاء حساب على خدمة Google Cloud ثم إنشاء مفتاح لحساب الخدمة.
عند إنشاء بطاقات باستخدام واجهة برمجة تطبيقات REST، يتم استخدام مفتاح حساب الخدمة لتوقيع كائنات البطاقات التي تحمل رمز JSON المميّز على الويب.
بالنسبة إلى العمليات الأخرى، مثل تعديل البطاقات أو حذفها، يتم إرسال مفتاح حساب الخدمة مع طلب المصادقة عليك بصفتك "جهة إصدار البطاقة".
1- تفعيل واجهة برمجة تطبيقات REST في محفظة Google
لتفعيل واجهة برمجة تطبيقات Google Wallet REST، عليك اتّباع الخطوات التالية:
- إذا لم يكن لديك حساب على Google Cloud، انتقِل إلى Google Cloud Console واتّبِع الخطوات لتسجيل حساب جديد.
- من القائمة المنسدلة للمشروع في أعلى وحدة التحكّم، اختَر مشروع Google Cloud الذي تريد استخدامه أو أنشئ مشروعًا جديدًا.
- انتقِل إلى صفحة تفاصيل منتج Google Wallet API في Google Cloud Console Marketplace.
- انقر على الزر "تفعيل". بعد بضع لحظات، ستصبح واجهة برمجة تطبيقات Google Wallet REST متاحة لمشروع Google Cloud المُحدّد.
2. إنشاء مفتاح حساب خدمة Google Cloud
لمصادقة الطلبات لواجهة برمجة تطبيقات Google Wallet REST، عليك إنشاء حساب خدمة وإنشاء مفتاح حساب خدمة من خلال اتّباع الخطوات التالية:
- انتقِل إلى صفحة "إنشاء حساب خدمة" في Google Cloud Console.
- املأ تفاصيل حساب الخدمة. دوِّن عنوان البريد الإلكتروني لحساب الخدمة الذي يظهر أسفل حقل "رقم تعريف حساب الخدمة". ستحتاج إلى هذه الطريقة لاحقًا عند استخدام حساب الخدمة لمصادقة طلباتك لواجهة Google Wallet REST API.
- انقر على الزر "تم". ليست هناك حاجة لإكمال خطوات إنشاء حساب الخدمة الأخرى.
- انقر على عنصر القائمة "المفاتيح" في أعلى الصفحة.
- انقر على القائمة المنسدلة "إضافة مفتاح"، ثم انقر على "إنشاء مفتاح جديد".
- اختَر نوع المفتاح "JSON".
- انقر على "إنشاء" لإنشاء مفتاح حساب الخدمة وتنزيله.
3- تفويض حساب الخدمة في وحدة تحكُّم "محفظة Google"
لمصادقة طلباتك المتعلّقة بواجهة Google Wallet REST API باستخدام مفتاح حساب خدمة، عليك إضافة عنوان البريد الإلكتروني لحساب الخدمة كمستخدم إلى حساب جهة الإصدار. لإضافة حساب الخدمة كمستخدم، عليك اتّباع الخطوات التالية:
- انتقِل إلى صفحة "حسابات الخدمة" في Google Cloud Console.
- انسخ عنوان البريد الإلكتروني لحساب الخدمة الذي تريد استخدامه لمصادقة طلباتك للوصول إلى Google Wallet API.
- انتقِل إلى وحدة تحكُّم Google Pay و"محفظة Google".
- في شريط التنقّل الأيمن، انقر على "المستخدمون".
- انقر على "دعوة مستخدم".
- أدخِل عنوان البريد الإلكتروني لحساب الخدمة.
- في القائمة المنسدلة "مستوى الوصول"، اختَر "مطوّر البرامج".
- انقر على الزر "دعوة".
بعد إضافة حساب الخدمة، يمكنك استخدام أي مفاتيح حساب خدمة تم إنشاؤها من أجل مصادقة الطلبات لواجهة برمجة تطبيقات Google Wallet REST. عند استخدام مفاتيح حساب الخدمة، ضع في اعتبارك أن بيانات الاعتماد هذه شديدة الحساسية ويجب استخدامها فقط في بيئات آمنة من جانب الخادم.