الخطوات الأولى
ما هي Google Wallet API؟
تتيح Google Wallet API للمطوّرين إنشاء بطاقات رقمية في "محفظة Google". تتيح Google Wallet API حاليًا استخدام بطاقات الصعود إلى الطائرة وتذاكر حضور الفعاليات وبطاقات الولاء والعروض وبطاقات النقل العام. وفي الآونة الأخيرة، تمت إضافة نوع بطاقة عام لدعم حالات استخدام إضافية.
كيف يمكنني إعداد بيئة تطوير البرامج وفقًا لمتطلبات نشاطي التجاري ودرجة التعقيد؟
في ما يلي أدلة يمكن استخدامها لإعداد بيئة تطوير تلبي مستويات مختلفة من تعقيد النشاط التجاري وأمانه. يمكن أن يتيح استخدام حسابات خدمة متعددة للمطوّرين إنشاء بيئة اختبار منفصلة عن بيئة PROD الخاصة بهم.
درجة تعقيد الإعداد الأساسي
حساب واحد على وحدة تحكّم النشاط التجاري أو حساب رئيسي واحد في وحدة تحكّم النشاط التجاري للعديد من حسابات الإصدار
- يتيح هذا الخيار نهجًا مُدارًا مركزيًا باستخدام حساب رئيسي واحد يضم من 0 إلى عدة أنشطة تجارية/جهات إصدار فرعية.
- مشروع واحد على Google Cloud
- بيانات اعتماد حساب خدمة واحدة
- مجموعة واحدة من المستخدمين
متوسط درجة تعقيد الإعداد
حساب رئيسي واحد لعدة حسابات مُصدِرين
- يتيح هذا الخيار منهجًا مُدارًا مركزيًا باستخدام حساب رئيسي واحد مع العديد من الأنشطة التجارية الفرعية.
- مشروع واحد على Google Cloud
- مستخدمو وحدة تحكّم النشاط التجاري المختلفون لكل جهة إصدار
- من بيانات اعتماد حساب خدمة واحدة إلى عدّة بيانات
- بيانات اعتماد واحدة لكل نشاط تجاري/جهة إصدار
- إمكانية الوصول إلى بيانات الاعتماد المختلفة لكل نشاط تجاري
تعقيد الإعداد المعقد
حساب رئيسي واحد إلى العديد من حسابات المُصدِرين
- يتيح هذا الخيار نهجًا مُدارًا مركزيًا باستخدام حساب رئيسي واحد يتضمّن العديد من الأنشطة التجارية الفرعية.
- من مشروع واحد إلى عدة مشاريع على Google Cloud
- مستخدمو وحدة تحكّم النشاط التجاري المختلفون لكل جهة إصدار
- من بيانات اعتماد حساب خدمة واحدة إلى عدّة بيانات
- بيانات اعتماد PROD واحدة لكل نشاط تجاري/جهة إصدار
- بيانات اعتماد DEV واحدة لكل نشاط تجاري أو جهة إصدار
العمل مع البطاقات
كيف يمكنني حذف الفئات أو الكائنات؟
لا يمكنك حاليًا حذف الصفوف أو العناصر من "محفظة Google". ومع ذلك، يمكن للمستخدمين إلغاء ربط العناصر من "محفظة Google".
كيف يمكنني تجميع تذاكر متعددة معًا؟
يسهِّل استخدام GroupingID تجميع البطاقات معًا.
كيف يمكنني تعديل جزء من البطاقة فقط؟
اتّبِع دليل الأداء للتعرّف على كيفية إجراء تعديلات جزئية باستخدام طلبات PATCH.
هل يمكنني إنشاء بطاقات بشكل مجمّع؟
اتّبِع دليل الأداء للتعرّف على كيفية تنفيذ طلبات مجمّعة باستخدام واجهة برمجة التطبيقات.
أسئلة عامة
ما هو الحد الأقصى لعدد الطلبات المُرسَلة إلى Google Wallet API؟
الحد الأقصى لمعدل المكالمات الواردة إلى Google Wallet API هو 20 طلبًا في الثانية.
لماذا يُحظر استخدام الصور الشخصية في البطاقات في "محفظة Google"؟
لا تتيح "محفظة Google" إضافة صور شخصية إلى البطاقات لأنّ اللوائح التنظيمية الحالية تنص على أنّه يحق لجميع المستهلكين إيقاف جمع البيانات الحسّاسة أو معالجتها. من خلال تضمين data حساسة (صور شخصية) كجزء من العنصر القيّم (في JWT)، قد تنشأ مخاوف متعلّقة بالاستضافة data حيث قد تصبح البيانات علنية خارج نطاق اتّفاقية الموافقة الأصلية. لأجل ضمان سرية البيانات، لا يُسمح بالصور الشخصية. نحن نعمل على إتاحة الصور الشخصية في المستقبل.
ما هي رموز الخطأ التي تعرضها Google Wallet API؟
للحصول على قائمة برموز الأخطاء والاستثناءات التي تعرضها Google Wallet API، اطّلِع على رموز الأخطاء.كيف يمكنني تفعيل الإشعارات الفورية؟
لا تتيح "محفظة Google" حاليًا إرسال إشعارات فورية من تأليف المطوّرين. ومع ذلك، توفِّر "محفظة Google" إشعارات في الوقت المناسب للبطاقات التالية. لا تتيح "محفظة Google" حاليًا إرسال إشعارات فورية من تأليف المطوّرين.
| موضع الإعلان | إشعار | تم التفعيل | الوثائق |
|---|---|---|---|
| الحدث | تذكير قادم | قبل 3 ساعات من موعد الحدث | docs |
| جواز مرور على متن طائرة | تذكير قادم | قبل 3 ساعات من موعد مغادرة الرحلة الجوية | docs |
| جواز مرور على متن طائرة | تعديل البطاقة | تغيير في المحطة أو البوابة أو وقت الصعود إلى الطائرة أو وقت المغادرة | docs |
| بطاقة العرض | تذكير بانتهاء الصلاحية | قبل 48 ساعة من انتهاء صلاحية بطاقة العرض | docs |
| Generic | تذكير قادم | قبل 24 ساعة من بدء "الفاصل الزمني" | مستندات |
| Generic | تذكير بشأن انتهاء الصلاحية | قبل 48 ساعة من انتهاء "الوقت الداخلي" | docs |
هل يمكن حذف معرّفات التجّار؟
لا يمكن حاليًا حذف أرقام تعريف التجار أو وضعها في الأرشيف من Google Pay & Wallet Console.
كيف يمكنني استخدام ميزة "ربط التطبيقات"؟
تتطلّب ميزة "ربط التطبيقات" إضافة التطبيقات إلى القائمة المسموح بها، ويمكن طلب ذلك هنا.
هل تتيح "محفظة Google" استخدام وضع الحدود الجغرافية؟
لا تتوفّر ميزة وضع حدود جغرافية حاليًا.
كيف يمكنني إعداد برنامج ولاء؟
يمكنك إعداد التسجيل في برنامج ولاء من خلال اتّباع هذا الدليل.
كيف يمكنني إرسال شعاري إلى Google لتصاريح النقل العام؟
يُرجى استخدام هذا النموذج لإرسال الشعار من أجل القائمة المسموح بها إلى Google.
كيف يتم التعامل بشكل صحيح مع بيانات userProfile المشفَّرة بتنسيق Base64؟
احرص على استخدام ترميز UTF-8 طوال العملية. يتم أولاً ترميز سلسلة JSON باستخدام ترميز UTF-8، ثم يتم ترميزها لاحقًا باستخدام android.util.Base64 مع الخيارَين NO_WRAP وURL_SAFE. يتوافق ذلك مع الفقرة 4 من RFC 3548.
كيف يمكنني إنشاء حسابات المُصدِرين آليًا؟
اطّلِع على هذا الدليل لإنشاء حسابات المُصدِرين من خلال واجهة برمجة التطبيقات.
الدفع الذكي
هل أحتاج إلى قارئ NFC خاص لبطاقات Google Smart Tap؟
يجب أن تكون محطة دفع تتيح استخدام تكنولوجيا الدفع الذكي. يمكنك الاطّلاع على قائمة بالمقدّمين المعتمَدين هنا.
كيف يمكنني أن أجعل بطاقاتي متوافقة مع تقنية NFC؟
يُرجى اتّباع هذه الضبط لتفعيل إمكانية تحصيل قيمة "الدفع الذكي" من بطاقتك.
الرموز المميّزة لبروتوكول JSON للويب (JWT)
هل هناك أدوات لتبسيط تنفيذ JWT وتصحيح الأخطاء؟
نعم، تتيح لك منصات مثل www.jwt.io فك ترميز الرموز المميّزة وتصحيح أخطاءها أثناء عملية التطوير، ما يتيح لك التحقّق من المحتوى الذي ترسله. تجدر الإشارة إلى أن Google لا تمتلك أي علاقة تبعية، ولا توصي بأي من هذه الجهات الخارجية على وجه التحديد.
يتجاوز عنوان URL لرابط JWT الحدّ الأقصى المسموح به للمتصفّح وهو 1800 حرف. ماذا يجب أن أفعل؟
يمكنك إنشاء الفئات والعناصر مسبقًا باستخدام واجهة برمجة التطبيقات قبل إنشاء رابط حفظ البطاقة (JWT).
تحديد المشاكل وحلّها
لماذا تعرض إعدادات الوقت وقتًا غير صحيح للفعالية؟
الوقت المعروض على البطاقة هو التوقيت المحلي للفعالية، مع إضافة فرق التوقيت إلى التوقيت المحلي للفعالية.
لا يظهر شعاري على البطاقات التي أنشأتها. ما هي المشكلة المحتملة؟
- أولاً، تأكَّد من أنّ شعارك يتّبع الإرشادات وأنّه يتم حفظه بتنسيق PNG.
- تأكَّد من توفّر الشعار بسهولة وبدرجة عالية من الموثوقية. لا تُعِد التوجيه إلى ملفات صور يمكن أن تؤدي إلى ظهور أخطاء 404. يجب استضافة صورك على موقع HTTPS لأنّها لن تظهر في "محفظة Google" بخلاف ذلك.
- تأكَّد من ضبط جميع الحقول المطلوبة في البطاقة، والتي تم وضع علامة "مطلوبة" عليها في واجهة برمجة التطبيقات.
الدعم والملاحظات
كيف يمكنني التواصل مع فريق الدعم الفني؟
للحصول على مساعدة إضافية، يُرجى التواصل مع فريق الدعم من خلال النقر على الزر "التواصل مع فريق الدعم" في الشريط الجانبي الأيمن من وحدة تحكّم Google Pay و"محفظة Google".
كيف يمكنني تقديم ملاحظات عن المنتج؟
لتقديم ملاحظات حول المنتج، انقر على الزر "إرسال ملاحظات" في الربع العلوي الأيسر من صفحة الموقع الإلكتروني للمطوّر، ثم اختَر "ملاحظات حول المنتج". بعد ذلك، أدخِل ملاحظاتك في منطقة النص وانقر على "إرسال".
كيف يمكنني تقديم ملاحظات عن المستندات؟
لتقديم ملاحظات حول المستندات، انقر على الزر "إرسال ملاحظات" في الربع العلوي الأيسر من صفحة الموقع الإلكتروني للمطوّر، ثم اختَر "ملاحظات حول المستندات". بعد ذلك، يُرجى وصف ملاحظاتك في مربّع النص والنقر على "إرسال".