تتيح ميزة التسجيل في بطاقة الهدايا (تسجيل الدخول) للمستخدمين البحث عن بطاقة هدايا وإضافتها إلى "محفظة Google". سيتم توجيه المستخدمين إلى موقعك الإلكتروني المتوافق مع الأجهزة الجوّالة لإكمال عملية الإضافة، وبعد ذلك يمكنهم إضافة بطاقاتهم إلى "محفظة Google".
يقدّم هذا الدليل نظرة عامة على خطوات التنفيذ المطلوبة لتفعيل ميزة "الاستبدال في المتجر" في برنامج بطاقات الهدايا.
نظرة عامة
للبدء، تأكَّد من أنّك سبق لك إعداد مشروعك وأنّ لديك إذن الوصول إلى Google Wallet API.
يجب اتّباع الخطوات الأربع التالية لتطبيق ميزة تسجيل الدخول لبرنامج بطاقات الهدايا:
- إعداد فئة اختبار في "محفظة Google" لاختبار عملية تسجيل الدخول
- أنشئ صفحات تسجيل دخول تستخدِم "محفظة Google"
SharedDataType. - تنفيذ إعادة إرسال بطاقة الهدايا إلى "محفظة 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"
WebView لنظام التشغيل Android، وسيتم إرسال طلب POST إلى عنوان URL الذي قدّمته. يتم تقديم بيانات المستخدم في المَعلمة SharedDataType
التي يتم تضمينها في طلب POST باستخدام نوع المحتوى
application/x-www-form-urlencoded و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.