نظرة عامة

تتيح واجهة Google Wallet Cards API للشركاء حفظ بياناتها. التدوير الرموز الشريطية إلى "محفظة Google" تكون هذه الرموز الشريطية صالحة فقط لفترة زمنية قصيرة، لتوفير أمان إضافي للحد من خطر التقاط لقطة شاشة للرمز الشريطي. تشير رسالة الأشكال البيانية يتم إنشاء الرموز الشريطية على الجهاز وفقًا وفقًا للمعيار RFC 6238، ويقدِّم الشريك المفتاح السري. مع ذلك، إذا كان الشريك يفضّل إنشاء الرموز الشريطية بنفسه، تقدّم Google واجهة برمجة تطبيقات تتيح تحميل الرموز الشريطية بشكل مجمّع إلى Google ستظهر هذه الرموز الشريطية بعد ذلك تمريرها إلى المستخدمين من الهواتف، حيث تعمل تمامًا مثل "رموز شريطية دوارة"، عرضها لفترة زمنية قصيرة. نشير إلى هذا الحل باسم من إنشاء الشركاء. جارٍ تدوير الرموز الشريطية

واجهة برمجة تطبيقات الرموز الشريطية بالتناوب التي ينشئها الشركاء

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

  rotatingBarcode {
    initialRotatingBarcodeValues: object (RotatingBarcodeValues),
    type: enum (BarcodeType),
  }

الحقل	الوصف
initialRotatingBarcodeValues	object (RotatingBarcodeValues) القيم المراد ترميزها في الرمز الشريطي. يجب إدخال قيمة واحدة على الأقل. تؤدي هذه القيم تهدف الرموز الشريطية إلى سد الفجوة بين وقت حصول المستخدم على البطاقة لأول مرة عند إجراء استدعاء التحميل المجمّع اللاحق.
type	enum (BarcodeType) مطلوب. نوع هذا الرمز الشريطي. القيم المقبولة هي: QR_CODE PDF_417

RotatingBarcodeValues

الحقل	الوصف
startDateTime	string التاريخ/الوقت الذي يكون فيه الرمز الشريطي الأول صالحًا. سيتم تدوير الرموز الشريطية من خلال باستخدام periodMillis. هذا التاريخ أو الوقت بالتنسيق الممتد وفقًا لمعيار ISO 8601، مع إزاحة.
values[]	string القيم المراد ترميزها في الرمز الشريطي. يجب إدخال قيمة واحدة على الأقل. ليس هناك حدّ أقصى لعدد القيم، ولكن يُرجى ملاحظة أنّ حجم نص الطلب لا يمكن أن يتجاوز حجمها 5 ميغابايت.
periodMillis	number المدة الزمنية التي يكون فيها كل رمز شريطي صالحًا.

يتم تعديل قيم الرمز الشريطي بشكل مجمّع.

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

الطريقة: transitobject.uploadrotatingbarcodevalues

تحمِّل قيم الرمز الشريطي الدوّارة إلى عنصر النقل العام المُشار إليه في رقم تعريف العنصر المحدّد.

طلب HTTP

POST https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc eId}/uploadRotatingBarcodeValues

مَعلمات المسار

المعلمة	الوصف
resourceId	string تمثّل هذه السمة المعرّف الفريد للعنصر.

نص الطلب

يحتوي نص الطلب (الذي لا يمكن أن يتجاوز 5 ميغابايت) على مثال RotatingBarcodeValues.

الطريقة: transitobject.downloadrotatingbarcodevalues

يتم تنزيل قيم الرمز الشريطي المتغيّرة لعنصر النقل العام المُشار إليه في العنصر المحدّد. رقم التعريف ويُعدّ هذا الإجراء مفيدًا إذا أراد الشركاء التحقّق من أحدث دفعة.

طلب HTTP

GET https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do wnloadRotatingBarcodeValues?alt=media

مَعلمات المسار

المعلمة	الوصف
resourceId	string تمثّل هذه السمة المعرّف الفريد للعنصر.

الآليات الاحتياطية

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