ייצוג 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_*}. הפרמטרים TotpParameters באינדקס n משמשים להחלפה {totp_value_n}. |
TotpAlgorithm
טיפוסים בני מנייה (enum) | |
---|---|
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 |
חובה. משך הזמן שבו כל ברקוד תקף. |