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)

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