تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع هذا الرمز الشريطي. |
renderEncoding |
ترميز عرض الرمز الشريطي. عند تحديده، يتم عرض الرمز الشريطي في الترميز المحدد. وبخلاف ذلك، يتم اختيار الترميز الأكثر شهرةً بواسطة Google. |
valuePattern |
قيمة رمز شريطي مرمّز على شكل سلسلة تتيح هذه السلسلة البدائل التالية: * {totp_value_n}: تم الاستبدال بقيمة TOTP (انظر TotpDetails.parameters). * {totp_timestamp_millis}: تم استبداله بالطابع الزمني (بأجزاء من الثانية منذ حقبة) الذي تم إنشاء الرمز الشريطي فيه. * {totp_timestamp_seconds}: تم استبداله بالطابع الزمني (بالثواني منذ بدء حساب الفترة) الذي تم إنشاء الرمز الشريطي فيه. |
totpDetails |
التفاصيل المستخدمة لتقييم {totp_value_n} عمليات الاستبدال. |
alternateText |
نص اختياري يلغي النص التلقائي الذي يظهر أسفل الرمز الشريطي. إنّ هذا الحقل مخصّص لشخص مكافئ لقيمة الرمز الشريطي يمكن قراءته، ويُستخدَم عندما يتعذّر مسح الرمز الشريطي ضوئيًا. |
showCodeText |
نص اختياري يتم عرضه عند إخفاء الرمز الشريطي خلف إجراء النقر. ويحدث ذلك في الحالات التي تكون فيها ميزة "الدفع الذكي" مفعّلة في البطاقة. وإذا لم يتم تحديد قيمة، تختار Google الإعدادات التلقائية. |
initialRotatingBarcodeValues |
الإدخال فقط. ملاحظة: لا تتوفّر هذه الميزة إلا لقطاع النقل العام. مجموعة اختيارية من قيم الرمز الشريطي المتغيّرة الأولية. ويتيح ذلك تضمين مجموعة فرعية صغيرة من الرموز الشريطية مع العنصر. يجب تحميل المزيد من قيم الرمز الشريطي المتغيرة باستخدام نقطة نهاية UploadRotatingBarcodeValues. |
TotpDetails
إعداد عمليات استبدال كلمات المرور لمرة واحدة (OTP) المستندة إلى الوقت يُرجى الاطّلاع على https://tools.ietf.org/html/rfc6238.
تمثيل JSON |
---|
{ "periodMillis": string, "algorithm": enum ( |
الحقول | |
---|---|
periodMillis |
الفاصل الزمني المستخدَم لإنشاء قيمة TOTP، بالمللي ثانية |
algorithm |
يشير ذلك المصطلح إلى خوارزمية TOTP المستخدمة لإنشاء كلمة المرور لمرة واحدة. |
parameters[] |
معلَمات TOTP لكل من عمليات الاستبدال {totp_value_*}. تُستخدم Totpparams في الفهرس n للاستبدال {totp_value_n}. |
TotpAlgorithm
عمليات التعداد | |
---|---|
TOTP_ALGORITHM_UNSPECIFIED |
|
TOTP_SHA1 |
خوارزمية TOTP من RFC 6238 باستخدام دالة التجزئة SHA1 |
TotpParameters
إعداد المفتاح وطول القيمة. يمكنك الاطّلاع على https://www.rfc-editor.org/rfc/rfc4226#section-5.3.
تمثيل JSON |
---|
{ "key": string, "valueLength": integer } |
الحقول | |
---|---|
key |
يتم استخدام المفتاح السري المستخدَم لإنشاء قيمة TOTP، والذي تم ترميزه كسلسلة Base16. |
valueLength |
طول قيمة TOTP بالأرقام العشرية. |
RotatingBarcodeValues
حمولة تحتوي على العديد من قيم الرمز الشريطي وتاريخ/وقت البدء.
تمثيل JSON |
---|
{ "startDateTime": string, "values": [ string ], "periodMillis": string } |
الحقول | |
---|---|
startDateTime |
مطلوب. التاريخ/الوقت الذي يكون فيه الرمز الشريطي الأول صالحًا. سيتم تدوير الرموز الشريطية باستخدام levelMillis المحددة في RotatingBarcodeValueInfo للكائن. هذا التاريخ أو الوقت بالتنسيق الممتد وفقًا لمعيار ISO 8601، مع إزاحة. يمكن تحديد الوقت بدقة تصل إلى نانو ثانية. يمكن تحديد الإزاحة بدقة بالثواني (على الرغم من أن ثوانٍ الإزاحة ليست جزءًا من ISO 8601). على سبيل المثال: ستكون
|
values[] |
مطلوب. القيم المراد ترميزها في الرمز الشريطي. يجب إدخال قيمة واحدة على الأقل. |
periodMillis |
مطلوب. المدة الزمنية التي يكون فيها كل رمز شريطي صالحًا. |