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

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

ما هي Google Wallet API؟

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

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

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

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

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

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

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

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

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

درجة تعقيد الإعداد

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

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

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

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

كيف يمكنني حذف صفوف أو عناصر؟

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

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

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

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

اتّبِع دليل الأداء للتعرّف على كيفية إجراء تعديلات جزئية باستخدام طلبات PATCH.

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

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

أسئلة عامة

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

يتم تحديد معدّل طلبات Google Wallet API بـ 20 طلبًا في الثانية.

لا تتضمّن Google Wallet API اتفاقية مستوى خدمة رسمية، ولكن ننصح بتحديد مهلة قدرها 10 ثوانٍ استنادًا إلى معدّل تأخير يبلغ 5 ثوانٍ تقريبًا في الشريحة المئوية الـ 99. يُرجى أيضًا العِلم أنّ وقت الاستجابة يعتمد غالبًا على عوامل خارجية، مثل الوقت اللازم لجلب صورة مستضافة على خادم خارجي عند إدراج عنصر يتضمّن تلك الصورة، لأنّ ذلك يعتمد على وقت استجابة الخادم الخارجي.

لماذا يُحظر استخدام الصور الشخصية في البطاقات في "محفظة Google"؟

لا تتيح "محفظة Google" استخدام صور شخصية على البطاقات لأنّ اللوائح التنظيمية الحالية تنص على أنّه يحق لجميع المستهلكين إيقاف جمع البيانات الحسّاسة أو معالجتها. من خلال تضمين بيانات حساسة (صور شخصية) كجزء من العنصر القيّم (في رمز JWT)، قد تنشأ مخاوف بشأن الاستضافة، إذ قد تصبح البيانات متاحة للجميع، وهو ما يتعارض مع اتفاقية الموافقة الأصلية. لضمان سرية البيانات، لا يُسمح باستخدام الصور الشخصية. نعمل على إتاحة الصور الشخصية في المستقبل.

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

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

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

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

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

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

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

كيف يمكنني استخدام ميزة Applinking؟

يتطلّب استخدام Applinking إدراج التطبيق في القائمة المسموح بها، ويمكن طلب ذلك هنا.

هل تتيح "محفظة Google" استخدام ميزة "السياج الجغرافي"؟

نعم، هذا الإجراء متاح. لمزيد من المعلومات، اطّلِع على تفعيل الإشعارات الفورية ضمن نوع البطاقة المعنيّ.

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

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

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

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

كيفية التعامل بشكل صحيح مع بيانات userProfile بترميز Base64

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

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

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

الدفع الذكي

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

يجب أن تكون محطة دفع تتيح استخدام تكنولوجيا Smart Tap. يمكنك الاطّلاع على قائمة بمقدّمي الخدمات المعتمدين هنا.

كيف يمكنني استخدام البطاقات مع تقنية NFC؟

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

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

هل تتوفّر أدوات تبسّط عملية تنفيذ رموز JWT المميزة وتصحيح أخطائها؟

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

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

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

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

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

لا يظهر شعاري على البطاقات التي أنشأتها. ما الخطأ المحتمل؟

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

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

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

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

كيف يمكنني تقديم ملاحظات وآراء عن المنتج؟

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

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

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