نظرة عامة

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

واجهة برمجة تطبيقات التفعيل

يتم تحديد نقطة نهاية التفعيل في واجهة برمجة التطبيقات باستخدام activationOptions على فئة النقل العام. الشريك مسؤول عن الحفاظ على نقطة نهاية تنشيط قيد التشغيل مع وقت استجابة معقول.

  activationOptions: {
    activationUrl: string
  }

الحقل	الوصف
activationUrl	string عنوان URL لنقطة نهاية الشريك التي سيتم طلبها لطلبات التفعيل. يجب أن يكون عنوان URL أن تتم استضافتها على HTTPS، وأن يتيح ملف robots.txt الوصول إلى مسار عنوان URL من خلال UserAgent:Google-Valuables

يتم حفظ حالة التفعيل في العنصر باستخدام الحقل activationStatus. تشمل الحالة الصالحة NOT_ACTIVATED وACTIVATED. التفعيل نقطة النهاية لتعديل الكائن باستخدام الحالة ACTIVATED بالإضافة إلى التأكد من يحتوي على معلومات صالحة لتحصيل القيمة، مثل الرمز الشريطي أو معايير الفحص المرئي. تشير رسالة الأشكال البيانية يمكن استخدام الحقل deviceContext لتثبيت الجهاز.

  activationStatus: enum (ActivationStatus),
  deviceContext: {
    deviceToken: string
  },
  hasLinkedDevice: boolean

الحقل	الوصف
activationStatus	enum (ActivationStatus) حالة تفعيل عنصر النقل العام هذا ستغير هذه الحالة تمثيل التذكرة وتسمح للمستخدمين باتخاذ الإجراءات؛ مثلاً: فسيتم عرض زر "تنشيط" على تفاصيل التذكرة إذا تم ضبط القيمة على NOT_ACTIVATED. القيم المقبولة هي: NOT_ACTIVATED ACTIVATED
deviceContext	object (DeviceContext) سياق الجهاز الذي يمكن ربط الكائن به وفي حال ضبطها، ستظهر أن يتم إرجاعه فقط إلى الجهاز المحدد.
hasLinkedDevice	boolean ما إذا كان هذا العنصر مرتبطًا حاليًا بجهاز واحد

DeviceContext

الحقل

الوصف

deviceToken

string في حال ضبط هذه السياسة، لن يتم عرض معلومات تحصيل القيمة إلا على الجهاز المحدَّد عند التفعيل. للكائن. ولا يمكن استخدام ذلك كمعرّف ثابت لتتبُّع جهاز المستخدم. أُنشأها جون هنتر، الذي كان متخصصًا يمكن أن يتغيّر على مستوى بطاقات مختلفة للجهاز نفسه أو حتى على بطاقات مختلفة عمليات التفعيل للجهاز نفسه. عند ضبط هذه الإعدادات، على المتصلين أيضًا ضبط hasLinkedDevice على العنصر الذي يتم تفعيله. يُرجى العلم بأنّه تم استلام "deviceToken" من. مَعلمات التفعيل حقل deviceContext

تثبيت الجهاز

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

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

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

مَعلمات التفعيل

سيحتوي الطلب إلى نقطة نهاية التفعيل على المعلمات التالية.

مثال على JSON:

  {
    classId: “123.classId”,
    objectIds: [ “123.objectId” ],
    expTimeMillis: 1669671940735,
    eventType: “activate”,
    nonce: “1c6fccce-6f66-11ed-a1eb-0242ac120002”,
    deviceContext: “6fba937a-6f6e-11ed-a1eb-0242ac120002”
  }

المُعرّف	الوصف
classId	معرّف الصف المؤهل بالكامل. تستخدم التنسيق التالي: <issuer_id.class_id>
objectIds	مصفوفة مؤهَّلة بالكامل لأرقام تعريف العناصر التي تستخدم التنسيق التالي: <issuer_id.object_id>
expTimeMillis	وقت انتهاء الصلاحية بالمللي ثانية منذ EPOCH. بعد وقت انتهاء الصلاحية، يلزم اعتبار الرسالة غير صالحة.
eventType	دائمًا "activate".
nonce	إشعار لتتبّع أي عمليات تسليم مكرّرة.
deviceContext	معرّف فريد تنشئه Google ويمثّل الجهاز الذي يتّخذ المستخدم إجراءً عليه ويجب استخدام هذا المعرّف عند إجراء تحديثات تربط كائنًا بأحد الأجهزة. قد لا يكون هذا المعرّف ثابتًا للطلبات المستقبلية من جهاز معين.