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

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

ما هي Google Wallet API؟

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

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

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

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

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

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

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

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

  • يتيح هذا الخيار اتّباع نهج مُدار مركزيًا باستخدام حساب رئيسي واحد يتضمّن العديد من الأنشطة التجارية الفرعية.
  • مشروع واحد على 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 ساعات من موعد الحدث docs
جواز مرور على متن طائرة تذكير قادم قبل 3 ساعات من موعد إقلاع الرحلة docs
جواز مرور على متن طائرة تعديل البطاقة تغيير في مبنى الركاب أو البوابة أو وقت الصعود إلى الطائرة أو وقت المغادرة docs
بطاقة العرض تذكير بانتهاء الصلاحية قبل 48 ساعة من انتهاء صلاحية بطاقة العرض docs
Generic تذكير قادم قبل 24 ساعة من بدء "الفاصل الزمني" docs
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 SmartTap؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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