تسمح ميزة تسجيل بطاقة الهدايا (تسجيل الدخول) للمستخدمين بالبحث عن بطاقة هدايا وإضافتها إلى "محفظة Google". وسيتم توجيه المستخدمين إلى موقعك الإلكتروني المتوافق مع الأجهزة الجوّالة لإكمال ليتمكّن العميل بعد ذلك من إضافة البطاقة إلى "محفظة Google".
يقدِّم هذا الدليل نظرة عامة على خطوات التنفيذ المطلوبة. لتفعيل برنامج بطاقات الهدايا لهذه الميزة.
نظرة عامة
للبدء، تأكد من إعداد مشروعك مسبقًا وتأكد من أنك تستطيع الوصول إلى Google Wallet API:
يجب اتّباع هذه الخطوات الأربع لتطبيق ميزة تسجيل الدخول. لبرنامج بطاقات الهدايا:
- عليك إعداد صف تجريبي في "محفظة Google" لاختبار مسار تسجيل الدخول.
- تطوير صفحات تسجيل الدخول التي تستخدم
SharedDataTypeفي محفظة Google. - يمكنك ردّ بطاقة الهدايا إلى "محفظة Google" بعد تسجيل الدخول.
- طلب إثبات الملكية والتفعيل
إعداد صف تجريبي في "محفظة Google"
حدِّد عنوان URL لتسجيل الدخول وشعار البرنامج. بعد ذلك، يُرجى اتّباع الخطوات التالية:
استخدام الحقول discoverableProgram المتداخلة في
giftcardclass لضبط
والقيم المناسبة.
اضبط القيم في discoverableProgram لإنشاء نسخة مسودة من
برنامج بطاقات الهدايا التي تم تفعيل إمكانية تسجيل الدخول إليها. للتأكّد من ظهور هذه المعلومات للمختبِرين، يُرجى
بإمكان المختبِرين الوصول إلى Google Pay وWallet Console. للحصول على تفاصيل حول كيفية مشاركة
إمكانية وصول مستخدمي Google Pay وWallet Console مع مستخدمين آخرين
معلومات حول صفحة "المستخدمون".
لإكمال عملية التحقّق من صحة وظائف عملية التنفيذ خلال مرحلة التطوير يمكنك التواصل معنا باستخدام تطبيق الدعم المصغّر في Google Pay وWallet Console. أثناء وجودك في وحدة التحكّم، واختَر Google Wallet API في الموضوع ثم انقر على تسجيل الدخول باستخدام بطاقة هدايا الموضوع الفرعي.
تطوير صفحة تسجيل دخول تستخدم بيانات مستخدم "محفظة Google"
عندما يختار أحد المستخدمين إضافة بطاقة الهدايا، يتم توجيهه إلى صفحة مخصصة على موقع الويب الخاص بك من أجل إكمال عملية تسجيل الدخول.
يجب تقديم عنوان URL لتسجيل الدخول يستطيع المستخدم تسجيل الدخول من خلاله. إلى حساب حالي.
يجب أن تستوفي صفحة تسجيل الدخول المتطلبات التالية:
- تقديم تجربة مستخدم متوافقة مع الأجهزة الجوّالة
- اسمح للمستخدم بإكمال عملية تسجيل الدخول في صفحة واحدة.
- استخدام تشفير
HTTPSمع شهادة صالحة لضمان أنّ بيانات المستخدم نقلها بأمان. - يجب التأكّد من أنّ وقت تشغيل صفحة تسجيل الدخول لا يقلّ عن% 99.9.
عند مشاركة عرض صفحة تسجيل الدخول، سينشئ تطبيق "محفظة Google"
تمّ تقديم طلب Android WebView وPOST إلى موقعك الذي قدّمته.
عنوان URL. يتم توفير بيانات المستخدمين في المعلمة SharedDataType
والمضمّن في طلب POST باستخدام
application/x-www-form-urlcoding نوع المحتوى و
ترميز UTF-8. قيمة SharedDataType
هي كائن JSON بترميز Base64.
الرد فورًا على بطاقة الهدايا في "محفظة Google"
بعد مصادقة (تسجيل الدخول)، ستظهر صفحتك رد بطاقة هدايا المستخدم على الفور إلى "محفظة Google".
يمكنك رد بطاقة الهدايا إلى "محفظة Google" من خلال إعادة التوجيه إلى رابط يتبع هيكل
https://pay.google.com/gp/v/save/{jwt_generated}
يبلغ الطول الآمن لعنوان URL 2000 حرف. يجب أن تكون روابطك أن يظل أقل من هذا الحد. يجب أن تكون الكائنات المُرمّزة في JWT صغيرة وتحتوي فقط على البيانات الخاصة بالمستخدم. حاول الاحتفاظ بمعظم البيانات في فئة الكائن، لإنشائه قبل إنشاء JWT. وبالنسبة إلى العناصر الأكبر حجمًا التي لا تناسب الحد المسموح به، يمكنك أولًا ننشئ الكائن في Google Wallet API وإرسال رقم تعريف العنصر فقط في JWT
تدفق التواصل النموذجي
يتم توضيح تدفق اتصال المستخدم الذي يكمل تسجيل الدخول في الصورة التالية. كل الإجراءات بين "خادمك" تقع على عاتقك مسئولية تنفيذها.
طلب إثبات الملكية والتفعيل
بعد إكمال عملية التطوير واختبار خطوات تسجيل الدخول، أرسِل طلبًا من خلال التواصل مع فريق الدعم في Google Pay وWallet Console التطبيق المصغّر.
بعد مراجعة كاملة لعملية التنفيذ التي تتأكّد من صحة الميزة في بالإضافة إلى تطبيق "محفظة Google"، ستتم إتاحة ميزة تسجيل الدخول إلى بطاقة الهدايا على نطاق علني في برنامج بطاقات الهدايا. سيسمح ذلك لأي مستخدم بالاطّلاع على البرنامج والاستفادة من هذه الميزة.
لضمان تقديم أفضل تجربة للمستخدم، ننصحك بإجراء عمليات متكررة لتسجيل الدخول. لضمان الامتثال الدائم لمتطلبات الميزة. سيتم إعلامك في حال رصد أي اختلافات في ميزة تسجيل الدخول. حتى يتم حل المشكلة.
الأسئلة الشائعة
- هل هناك أي متطلبات للصور المستخدَمة في برنامج بطاقات الهدايا؟
- نعم، يجب استضافة صورك على موقع جغرافي واحد (
HTTPS). لأنّها لن تظهر في "محفظة Google" بخلاف ذلك.
- نعم، يجب استضافة صورك على موقع جغرافي واحد (
- هل هناك أي أدوات تبسّط تنفيذ JWT وتصحيح الأخطاء؟
- نعم، منصات مثل يسمح لك www.jwt.io بفك ترميز وتصحيح الأخطاء في الرموز المميزة أثناء عملية التطوير، ما يتيح لك التحقق من المحتوى الذي ترسله. يُرجى ملاحظة أنّ شركة Google لا تنتمي إلى أي شركة أن توصي بأي من هذه الجهات الخارجية على وجه التحديد.
- كيف نتعامل بشكل صحيح مع بيانات SharedDataType المشفَّرة بتنسيق Base64؟
- تأكّد من استخدام ترميز UTF-8 خلال العملية. سلسلة JSON هو أول ما يتم ترميزه باستخدام UTF-8، ثم يتم ترميزه لاحقًا باستخدام android.util.Base64 مع الخيارين NO_WRAP وURL_SAFE. يتوافق هذا مع الفقرة 4 من معيار RFC 3548.