تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع هذا الرمز الشريطي. |
render |
ترميز العرض للرمز الشريطي عند تحديده، يتم عرض الرمز الشريطي بترميز معيّن. وفي حال عدم توفّر ترميز، تختار Google أفضل ترميز معروف. |
value |
قيمة الرمز الشريطي المشفَّرة بسلسلة تتيح هذه السلسلة الاستبدالات التالية: * {totp_value_n}: يتم استبدالها بقيمة TOTP (راجِع TotpDetails.parameters). * {totp_timestamp_millis}: يتم استبداله بالطابع الزمني (بالملي ثانية منذ بدء حساب الفترة) الذي تم إنشاء الرمز الشريطي فيه. * {totp_timestamp_seconds}: يتم استبدالها بالطابع الزمني (بالثواني منذ بداية الحقبة) الذي تم إنشاء الرمز الشريطي فيه. |
totp |
التفاصيل المستخدَمة لتقييم عمليات الاستبدال {totp_value_n} |
alternate |
نص اختياري يلغي النص التلقائي الذي يظهر أسفل الرمز الشريطي. يُستخدَم هذا الحقل لعرض قيمة رمز شريطي قابلة للقراءة من قِبل البشر، وذلك عندما يتعذّر مسح الرمز الشريطي ضوئيًا. |
show |
نص اختياري سيتم عرضه عندما يكون الرمز الشريطي مخفيًا خلف إجراء النقر. ويحدث ذلك في الحالات التي تكون فيها ميزة "الدفع الذكي" مفعّلة في البطاقة. إذا لم يتم تحديد قيمة، سيختار محرّك بحث Google قيمة تلقائية. |
initial |
الإدخال فقط. ملاحظة: لا تتوفّر هذه الميزة إلا لقطاع النقل العام. مجموعة اختيارية من قيم الرمز الشريطي المتغيّر الأولي يتيح ذلك تضمين مجموعة فرعية صغيرة من الرموز الشريطية مع العنصر. يجب تحميل المزيد من قيم الرمز الشريطي المتغيرة باستخدام نقطة نهاية UploadRotatingBarcodeValues. |
TotpDetails
إعداد عمليات استبدال كلمات المرور لمرة واحدة (OTP) المستندة إلى الوقت يُرجى الاطّلاع على https://tools.ietf.org/html/rfc6238.
تمثيل JSON |
---|
{ "periodMillis": string, "algorithm": enum ( |
الحقول | |
---|---|
period |
الفاصل الزمني المستخدَم لإنشاء قيمة TOTP، بالملي ثانية |
algorithm |
خوارزمية TOTP المستخدَمة لإنشاء كلمة المرور لمرة واحدة |
parameters[] |
مَعلمات TOTP لكلٍّ من عمليات الاستبدال {totp_value_*}. يتم استخدام مَعلمات TotpParameters في الفهرس 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. |
value |
طول قيمة TOTP بالأرقام العشرية |
RotatingBarcodeValues
حمولة تحتوي على العديد من قيم الرمز الشريطي وتاريخ/وقت البدء.
تمثيل JSON |
---|
{ "startDateTime": string, "values": [ string ], "periodMillis": string } |
الحقول | |
---|---|
start |
مطلوب. التاريخ/الوقت الذي يكون فيه الرمز الشريطي الأول صالحًا. سيتم تدوير الرموز الشريطية باستخدام مَعلمة periodMillis المحدّدة في RotatingBarcodeValueInfo للعنصر. هذا التاريخ أو الوقت بالتنسيق الممتد وفقًا لمعيار ISO 8601، مع إزاحة. يمكن تحديد الوقت بدقة تصل إلى النانو ثانية. يمكن تحديد الإزاحة بدقة بالثواني (على الرغم من أن ثوانٍ الإزاحة ليست جزءًا من ISO 8601). على سبيل المثال: سيكون
|
values[] |
مطلوب. القيم المطلوب ترميزها في الرمز الشريطي يجب إضافة قيمة واحدة على الأقل. |
period |
مطلوب. المدة التي يكون فيها كل رمز شريطي صالحًا |