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

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 באפריל 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)

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