الأسئلة الشائعة حول Google Wallet API

الخطوات الأولى

ما هي Google Wallet API؟

تسمح Google Wallet API للمطوّرين بإنشاء بطاقات رقمية في "محفظة Google". تتيح Google Wallet API حاليًا بطاقات صعود الطائرة وتذاكر حضور الفعاليات وبطاقات الولاء والعروض وبطاقات النقل العام. وفي الآونة الأخيرة، تمت إضافة نوع بطاقة عام لإتاحة المزيد من حالات الاستخدام.

كيف يمكنني إعداد بيئة مطوّري البرامج استنادًا إلى متطلبات نشاطي التجاري ومدى التعقيد؟

في ما يلي بعض الأدلة التي يمكن استخدامها لإعداد بيئة تطوير تلبي مختلف مستويات التعقيد والأمان في النشاط التجاري. يمكن أن يتيح استخدام حسابات خدمة متعددة للمطوّرين إنشاء بيئة "اختبار" منفصلة عن بيئة PROD.

درجة التعقيد الأساسية في عملية الإعداد

حساب واحد لوحدة تحكّم الأنشطة التجارية أو حساب رئيسي واحد على وحدة تحكّم الأنشطة التجارية للعديد من حسابات جهات الإصدار.

  • يتيح هذا الخيار نهجًا مُدارًا مركزيًا باستخدام حساب رئيسي واحد بدون حساب العديد من الأنشطة التجارية الفرعية/جهات الإصدار الفرعية.
  • مشروع واحد على Google Cloud
  • بيانات اعتماد واحدة لحساب الخدمة
  • مجموعة واحدة من المستخدمين.

متوسط درجة تعقيد الإعداد

حساب رئيسي واحد للعديد من حسابات جهات الإصدار

  • يتيح هذا الخيار نهجًا مُدارًا مركزيًا باستخدام حساب رئيسي واحد مع العديد من الأنشطة التجارية الفرعية.
  • مشروع واحد على Google Cloud
  • المستخدمون الفريدون لوحدة تحكم النشاط التجاري لكل جهة إصدار.
  • 1 إلى العديد من بيانات اعتماد حساب الخدمة.
    • تتوفر بيانات اعتماد واحدة لكل نشاط تجاري/جهة إصدار.
    • تختلف أذونات الوصول لبيانات الاعتماد الخاصة بكل نشاط تجاري.

عملية إعداد معقّدة

حساب رئيسي واحد للعديد من حسابات جهات الإصدار

  • يتيح هذا الخيار نهجًا مُدارًا مركزيًا باستخدام حساب رئيسي واحد مع العديد من الأنشطة التجارية الفرعية.
  • 1 إلى العديد من مشاريع Google Cloud.
  • المستخدمون الفريدون لوحدة تحكم النشاط التجاري لكل جهة إصدار.
  • 1 إلى العديد من بيانات اعتماد حساب الخدمة.
    • تتوفر بيانات اعتماد PROD واحدة لكل نشاط تجاري/جهة إصدار.
    • يجب أن تتوفّر بيانات اعتماد DEV واحدة لكل نشاط تجاري أو جهة إصدار.

اتصل بفريق الدعم

استخدام البطاقات

كيف يمكنني حذف الفئات أو الكائنات؟

لا يمكنك حاليًا حذف الفئات أو العناصر من "محفظة Google". ويمكن للمستخدمين إلغاء ربط العناصر من "محفظة Google".

كيف يمكنني تجميع عدة بطاقات معًا؟

يسهّل استخدام GroupingID تجميع البطاقات معًا.

كيف يمكنني تعديل جزء فقط من بطاقة؟

يمكنك اتّباع دليل الأداء لفهم كيفية إجراء تعديلات جزئية باستخدام طلبات الملخّص.

هل يمكنني إنشاء بطاقات مجمّعة معًا؟

اتّبِع دليل الأداء لفهم كيفية تنفيذ الطلبات المجمّعة باستخدام واجهة برمجة التطبيقات.

أسئلة عامة

ما هو الحدّ الأقصى لمعدّل الطلبات المرسَلة إلى Google Wallet API؟

لا يمكن أن يزيد معدل المكالمات الواردة إلى Google Wallet API عن 20 طلبًا في الثانية.

ما هي رموز الخطأ التي تعرضها Google Wallet API؟

للحصول على قائمة برموز الخطأ والاستثناءات التي تعرضها Google Wallet API، يُرجى مراجعة رموز الخطأ.

كيف يمكنني تفعيل الإشعارات الفورية؟

لا يمكن حاليًا استخدام الإشعارات الفورية من إنشاء المطوِّرين في "محفظة Google". مع ذلك، تقدّم خدمة "محفظة Google" إشعارات في الوقت المناسب بشأن البطاقات التالية. لا يمكن حاليًا استخدام الإشعارات الفورية من إنشاء المطوِّرين في "محفظة Google".

رأسي إشعار تم التفعيل الوثائق
حدث تذكير قادم قبل 3 ساعات من موعد الحدث docs
جواز المرور على متن الطائرة تذكير قادم قبل 3 ساعات من موعد مغادرة الرحلة الجوية docs
جواز المرور على متن الطائرة تحديث البطاقة تغيير محطة الركّاب أو البوابة أو وقت الصعود إلى الطائرة أو وقت المغادرة docs
بطاقة العرض تذكير بانتهاء الصلاحية قبل 48 ساعة من انتهاء صلاحية بطاقة العرض docs
Generic تذكير قادم قبل 24 ساعة من بدء "الفاصل الزمني" docs
Generic تذكير بانتهاء الصلاحية قبل 48 ساعة من انتهاء "الوقت الداخلي" docs

هل يمكن حذف معرّفات التجّار؟

في الوقت الحالي، لا يمكن حذف معرّفات التجّار أو أرشفتها من Google Pay & Wallet Console.

كيف أستخدم ميزة "ربط التطبيق"؟

يتطلّب ربط التطبيقات إضافة إلى القائمة المسموح بها، ويمكن طلبها هنا.

هل تتيح "محفظة Google" وضع الحدود الجغرافية؟

ميزة "الحدود الجغرافية" غير متاحة حاليًا.

كيف يمكنني إعداد برنامج ولاء؟

يمكنك إعداد تسجيل وبرنامج ولاء باتّباع هذا الدليل.

كيف يمكنني إرسال شعاري إلى Google لبطاقات النقل العام؟

يُرجى استخدام هذا النموذج لإرسال شعار Google لإدراجه في القائمة المسموح بها.

كيف يتم التعامل بشكل صحيح مع بيانات الملف الشخصي للمستخدم التي تم ترميزها باستخدام Base64؟

تأكَّد من استخدام ترميز UTF-8 في مختلف مراحل العملية. يتم ترميز سلسلة JSON أولاً بترميز UTF-8، وبعد ذلك يتم ترميزها باستخدام android.util.Base64 مع الخيارين NO_WRAP وURL_SAFE. يتوافق ذلك مع القسم 4 من RFC 3548.

كيف يمكنني إنشاء حسابات جهة الإصدار آليًا؟

يمكنك الاطّلاع على هذا الدليل لإنشاء حسابات جهات الإصدار من خلال واجهة برمجة التطبيقات.

الدفع الذكي

هل أحتاج إلى قارئ NFC خاص لبطاقات Google SmartTap؟

يجب أن يكون الجهاز وحدة طرفية متوافقة مع ميزة "الدفع الذكي". يمكنك العثور هنا على قائمة بمقدّمي الخدمات المعتمَدين.

كيف يمكنني جعل بطاقاتي متوافقة مع تقنية NFC؟

يُرجى اتّباع هذه الضبط من أجل تفعيل إمكانية تحصيل قيمة بطاقتك من خلال ميزة "الدفع الذكي".

رموز JSON المميّزة للويب (JWT)

هل هناك أدوات تبسّط تنفيذ JWT وتصحيح الأخطاء فيها؟

نعم، تتيح لك المنصات مثل www.jwt.io فك ترميز الرموز المميّزة وتصحيح الأخطاء فيها أثناء عملية التطوير، ما يتيح لك التحقّق من المحتوى الذي ترسله. تجدر الإشارة إلى أنّ Google لا تنتمي إلى أي جهة، ولا تنصح على وجه التحديد بأي من هذه الجهات الخارجية.

يمكنك إنشاء الفئات والكائنات مسبقًا باستخدام واجهة برمجة التطبيقات قبل إنشاء رابط حفظ البطاقة (JWT).

تحديد المشاكل وحلّها

لماذا يعرض إعداد الوقت الوقت غير الصحيح للحدث؟

يشير الوقت المعروض على البطاقة إلى التوقيت المحلي للحدث، مع معادلة للوقت الذي تقام فيه الفعالية.

لن يتم عرض شعاري على البطاقات التي أنشأتُها. ماذا يمكن أن يكون الخطأ؟

  • أولاً، تأكَّد من أنّ شعارك يتّبع الإرشادات وأنّه محفوظ بتنسيق PNG.
  • تأكَّد من أنّ الشعار متاح بسهولة وموثوقية عالية. لا تُعِد التوجيه إلى ملفات صور قد تؤدي إلى حدوث أخطاء 404. يجب أن تكون صورك مستضافة على موقع HTTPS، لأنّها لن تظهر في "محفظة Google".
  • تأكَّد من أنّ جميع الحقول المطلوبة التي تم وضع علامة "مطلوبة" في واجهة برمجة التطبيقات عليها قد تم ضبطها في البطاقة.

الدعم والملاحظات

كيف أتواصل مع فريق الدعم الفني؟

للحصول على مساعدة إضافية، يُرجى التواصل مع فريق الدعم بالنقر على الزر "التواصل مع فريق الدعم" في الشريط الجانبي الأيمن من وحدة تحكّم Google Pay و"محفظة Google".

كيف يمكنني تقديم ملاحظات حول المنتج؟

لإرسال ملاحظات حول المنتج، يُرجى النقر على زر "إرسال ملاحظات" في أعلى يسار صفحة صفحة المطوِّر والنقر على "ملاحظات حول المنتج". بعد ذلك، أدخِل ملاحظاتك في مربّع النص وانقر على "إرسال".

كيف يمكنني ترك ملاحظاتي على الوثائق؟

لإرسال ملاحظات حول المستندات، يُرجى النقر على زر "إرسال ملاحظات" في أعلى يسار صفحة موقع المطوِّر الإلكتروني واختيار "ملاحظات حول المستندات". بعد ذلك، أدخِل ملاحظاتك في مربّع النص وانقر على "إرسال".