نظرة عامة

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

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

حالات الاستخدام

في ما يلي بعض أمثلة حالات الاستخدام التي تتناسب مع النموذج للقطاع العام:

  • بطاقات ركن السيارات
  • بطاقات الاشتراك في المكتبة
  • قسائم شراء ذات قيمة مضافة
  • بطاقات الانتساب للنادي الرياضي
  • بطاقات التأمين على السائق
  • حجوزات من أنواع مختلفة
  • رمز البلد عبر الحدود
  • رموز تأكيد الشاشة المُسبَقة للعميل

حالات الاستخدام التي تتضمن معلومات حساسة

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

خطوات الدمج

يجب تنفيذ الخطوات التالية لدمج البطاقة مع Google Wallet API. يُرجى اختيار نوع الدمج أدناه حسب ما إذا كنت تصل إلى عملائك على أجهزة Android فقط أو على Android أو الويب أو البريد الإلكتروني أو الرسائل القصيرة SMS.

Android أو الويب أو البريد الإلكتروني أو الرسائل القصيرة SMS

  1. اطّلِع على آلية عمل الصفوف والكائنات وتعرَّف على مسارات الإضافة إلى "محفظة Google".
  2. إكمال المتطلبات الأساسية
    • أنشِئ مشروعًا على Google Cloud باستخدام حساب خدمة ومفتاح خاص.
    • أنشئ حسابًا لنشاطك التجاري في Google Pay وWallet Console.
    • تفويض حساب الخدمة في Google Pay وWallet Console
    • تفعيل Google Wallet API
    • إنشاء صف
  3. [إجراء اختياري] إنشاء بطاقة باستخدام أداة العرض المرئي للبطاقات لإنشاء ملف JSON للصفوف والكائنات
  4. أنشئ رابط JWT يتضمّن الصف والعنصر الموقَّعَين باستخدام مفتاحك الخاص.
  5. عرض الزر "إضافة إلى محفظة Google" في تطبيقك
  6. إكمال قائمة التحقّق
  7. طلب الإذن بنشر المحتوى في Google Pay وWallet Console

نظام التشغيل Android فقط

  1. اطّلِع على آلية عمل الصفوف والكائنات وتعرَّف على مسارات الإضافة إلى "محفظة Google".
  2. إكمال المتطلبات الأساسية
  3. [إجراء اختياري] إنشاء بطاقة باستخدام أداة العرض المرئي للبطاقات لإنشاء ملف JSON للصفوف والكائنات
  4. أنشئ بطاقة عن طريق حفظ ملف JWT موقَّع أو من خلال حفظ ملف JSON غير موقَّع باستخدام حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
  5. انقر على الزر "إضافة إلى محفظة Google" في تطبيقك.
  6. إكمال قائمة التحقّق
  7. طلب الإذن بنشر المحتوى في Google Pay وWallet Console

البدء

وللحصول على إرشادات من خلال هذه الخطوات، يمكنك بدء استخدام الدروس التطبيقية حول الترميز لالويب ولنظام التشغيل Android، أو يمكنك البدء باختيار عملية الدمج المناسبة لك. يعتمد الدمج المناسب لك على متطلباتك المحددة ويستند بشكل أساسي إلى الطريقة التي تريد الوصول بها إلى عملائك.