نظرة عامة على البطاقة العامة

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

أمثلة على حالات الاستخدام

في ما يلي بعض الأمثلة على ما يمكنك فعله باستخدام نوع البطاقة العامة:

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

البطاقات التي تتضمّن معلومات حسّاسة

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

المنصّات المعتمدة

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

واجهات برمجة التطبيقات وحُزم تطوير البرامج (SDK)

توفّر Google Wallet API واجهة برمجة تطبيقات REST وحزمة تطوير برامج (SDK) لنظام التشغيل Android لمساعدتك في إصدار بطاقاتك وإدارتها بسرعة وسهولة.

  • Google Wallet REST API

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

  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android في "محفظة Google"

    لإصدار البطاقات في تطبيق Android، ننصحك باستخدام حزمة تطوير البرامج (SDK) لنظام التشغيل Android في "محفظة Google". توفر حزمة SDK مجموعة متنوعة من الطرق المريحة التي تسهل دمج Google Wallet API في تطبيقاتك للأجهزة الجوّالة باستخدام رموز برمجية أصلية.

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

المتطلّبات

لإصدار بطاقات باستخدام Google Wallet API، عليك أولاً تنفيذ ما يلي:

بدء استخدام Google Wallet API

قبل بدء استخدام Google Wallet API، ألقِ نظرة على هذه المقالات المفيدة التي ستعرّفك على الميزات والمصطلحات الأساسية.

الأدوات والمراجع

  • الدروس التطبيقية حول الترميز

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

    Android الويب

  • أداة إنشاء البطاقات

    يمكنك إنشاء بطاقتك الأولى بشكل مرئي باستخدام أداة إنشاء البطاقات وإنشاء ملف JSON الذي تحتاجه تلقائيًا لإنشاء البطاقة باستخدام Google Wallet API.

  • GitHub في "محفظة Google"

    يمكنك الحصول على أدوات ومكتبات ورموز نموذجية مفيدة لمجموعة متنوعة من لغات البرمجة في مؤسسة محفظة Google في Github.