RotatingBarcode

ייצוג JSON
{
  "type": enum (BarcodeType),
  "renderEncoding": enum (BarcodeRenderEncoding),
  "valuePattern": string,
  "totpDetails": {
    object (TotpDetails)
  },
  "alternateText": string,
  "showCodeText": {
    object (LocalizedString)
  },
  "initialRotatingBarcodeValues": {
    object (RotatingBarcodeValues)
  }
}
שדות
type

enum (BarcodeType)

סוג הברקוד הזה.

renderEncoding

enum (BarcodeRenderEncoding)

הקידוד של הברקוד לעיבוד. אם צוין, הברקוד מעובד לפי הקידוד הנתון. במקרים אחרים, הקידוד הידוע ביותר נבחר על ידי Google.

valuePattern

string

ערך ברקוד עם קידוד מחרוזת. המחרוזת הזו תומכת בחלופות הבאות: * {totp_value_n}: הוחלף בערך TOTP (מידע נוסף זמין ב-TotpDetails.parameters). * {totp_timestamp_millis}: הוחלף בחותמת הזמן (אלפיות שנייה מתחילת התקופה) שבה נוצר הברקוד. * {totp_timestamp_seconds}: הוחלף בחותמת הזמן (מספר השניות מאז תחילת התקופה) שבה נוצר הברקוד.

totpDetails

object (TotpDetails)

פרטים שמשמשים להערכת החלפות של {totp_value_n}.

alternateText

string

טקסט אופציונלי שיחליף את טקסט ברירת המחדל שמוצג מתחת לברקוד. השדה הזה מיועד לערך קריא (לבני אדם) של ערך הברקוד, שמשמש כשלא ניתן לסרוק את הברקוד.

showCodeText

object (LocalizedString)

טקסט אופציונלי שיוצג כשהברקוד מוסתר מאחורי פעולת קליק. המצב הזה קורה אם בכרטיס מופעלת התכונה 'הקשה חכמה'. אם לא מציינים זאת, Google תבחר ברירת מחדל.

initialRotatingBarcodeValues

object (RotatingBarcodeValues)

קלט בלבד. הערה: התכונה הזו זמינה רק בענף התחבורה. קבוצה אופציונלית של ערכי ברקוד מסתובבים ראשוניים. כך אפשר לכלול עם האובייקט קבוצת משנה קטנה של ברקודים. יש להעלות ערכי ברקוד מסתובבים נוספים באמצעות נקודת הקצה UploadRotatingBarcodeValues.

TotpDetails

הגדרות אישיות להחלפת OTP לפי זמן. מידע נוסף זמין בכתובת https://tools.ietf.org/html/rfc6238

ייצוג JSON
{
  "periodMillis": string,
  "algorithm": enum (TotpAlgorithm),
  "parameters": [
    {
      object (TotpParameters)
    }
  ]
}
שדות
periodMillis

string (int64 format)

מרווח הזמן המשמש ליצירת ערך TOTP, באלפיות שנייה.

algorithm

enum (TotpAlgorithm)

אלגוריתם ה-TOTP ששימש ליצירת ה-OTP.

parameters[]

object (TotpParameters)

הפרמטרים של 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

string

המפתח הסודי המשמש ליצירת ערך TOTP, מקודד כמחרוזת Base16.

valueLength

integer

אורך הערך של TOTP בספרות עשרוניות.

RotatingBarcodeValues

מטען ייעודי (payload) שמכיל הרבה ערכי ברקוד ותאריך התחלה ותאריך התחלה.

ייצוג JSON
{
  "startDateTime": string,
  "values": [
    string
  ],
  "periodMillis": string
}
שדות
startDateTime

string

חובה. התאריך והשעה שבהם הברקוד הראשון בתוקף. הברקודים יעברו רוטציה באמצעות periodMillis שמוגדר ב-RotatingBarcodeValueInfo של האובייקט.

זהו תאריך/שעה בפורמט מורחב לפי תקן ISO 8601, עם קיזוז. ניתן לציין זמן עד לרמת דיוק של ננו-שנייה. ניתן לציין היסט בדיוק בשניות (למרות ששניות היסט הן חלק מתקן ISO 8601).

לדוגמה:

1985-04-12T23:20:50.52Z יהיה 20 דקות ו-50.52 שניות אחרי השעה ה-23 של 12 באפריל 1985 לפי שעון UTC.

1985-04-12T19:20:50.52-04:00 יהיה 20 דקות ו-50.52 שניות אחרי השעה ה-19 של 12 באפריל 1985, 4 שעות לפני שעון UTC (אותה נקודת זמן כמו בדוגמה שלמעלה). אם האירוע היה בניו יורק, הוא היה מקביל לשעון קיץ של החוף המזרחי (EDT). חשוב לזכור שההיסט שונה באזורים שבהם יש שעון קיץ (או שעון קיץ), בהתאם לעונה בשנה.

values[]

string

חובה. הערכים לקידוד בברקוד. חובה למלא לפחות ערך אחד.

periodMillis

string (int64 format)

חובה. משך הזמן שבו כל ברקוד תקף.