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

البدء

ما هي Google Wallet API؟

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

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

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

التعقيد الأساسي في الإعداد

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

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

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

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

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

تعقيد الإعداد

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

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

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

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

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

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

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

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

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

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

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

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

أسئلة عامة

ما هو الحدّ الأقصى لمعدّل الطلبات المرسَلة إلى 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.

كيف أستخدم ميزة Applink؟

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

هل تتيح "محفظة 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".

كيف يمكنني ترك تعليقات حول المنتج؟

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

كيف يمكنني ترك ملاحظات عن المستندات؟

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