تسمح ميزة تسجيل بطاقة الهدايا (تسجيل الدخول) للمستخدمين بالبحث عن بطاقة هدايا وإضافتها إلى "محفظة 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"
تمّ تقديم طلب Android WebView و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.