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

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

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

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

  • بطاقات ركن السيارات
  • بطاقات المكتبات
  • بطاقات الاشتراك
  • بطاقات التأمين
  • تأكيدات الحجز
  • رموز تأكيد البيانات التي تم فحصها مسبقًا للعملاء

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

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

المنصّات المتوافقة

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

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

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

  • Google Wallet REST API

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

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

    لإصدار البطاقات في تطبيق Android، ننصحك باستخدام حزمة تطوير البرامج (SDK) لـ "محفظة Google" على Android. توفّر حزمة 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، ننصحك بالاطّلاع على هذه المقالات المفيدة التي ستعرّفك على الميزات والمصطلحات الأساسية.

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

  • Codelabs

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

    Android الويب

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

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

  • Google Wallet Github

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