ייצוג 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 שמשמש ליצירת ה-OTP. |
parameters[] |
הפרמטרים של TOTP לכל אחד מהחלופות {totp_value_*}. הפרמטרים של TotpParameter באינדקס n משמשים להחלפה {totp_value_n}. |
TotpAlgorithm
טיפוסים בני מנייה (enums) | |
---|---|
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
מטען ייעודי (payload) שמכיל ערכים רבים של ברקוד ותאריך התחלה ושעת התחלה.
ייצוג JSON |
---|
{ "startDateTime": string, "values": [ string ], "periodMillis": string } |
שדות | |
---|---|
startDateTime |
חובה. התאריך/השעה שמהם הברקוד הראשון תקף. הברקודים יסתובבו באמצעות periodMillis שמוגדר ב-RotatingBarcodeValueInfo של האובייקט. זהו תאריך/שעה בפורמט מורחב לפי תקן ISO 8601, עם קיזוז. ניתן להגדיר זמן עד לדיוק של ננו-שניות. ניתן לציין קיזוזים ברמת דיוק של שניות (למרות ששניות היסט אינן חלק מ-ISO 8601). למשל:
|
values[] |
חובה. הערכים שצריך לקודד בברקוד. נדרש לפחות ערך אחד. |
periodMillis |
חובה. משך הזמן שבו כל ברקוד תקף. |