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 المستخدَمة لإنشاء كلمة المرور لمرة واحدة

parameters[]

object (TotpParameters)

مَعلمات TOTP لكلٍّ من عمليات الاستبدال {totp_value_*}. يتم استخدام مَعلمات TotpParameters في الفهرس n لاستبدال {totp_value_n}.

TotpAlgorithm

عمليات التعداد
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

حمولة تحتوي على العديد من قيم الرمز الشريطي وتاريخ/وقت البدء.

تمثيل 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 بالتوقيت العالمي المتفق عليه.

1985-04-12T19:20:50.52-04:00 ستكون بعد 20 دقيقة و50.52 ثانية من الساعة 19 من 12 نيسان (أبريل) 1985، قبل 4 ساعات من التوقيت العالمي المنسَّق (UTC) (الوقت الفعلي نفسه كما في المثال أعلاه). إذا كانت الفعالية في نيويورك، ستكون معادِل التوقيت الصيفي الشرقي (EDT). تجدر الإشارة إلى أنّ التوقيت يختلف في المناطق التي تطبّق التوقيت الصيفي (أو التوقيت الصيفي)، بناءً على الوقت من السنة.

values[]

string

مطلوب. القيم المطلوب ترميزها في الرمز الشريطي يجب إضافة قيمة واحدة على الأقل.

periodMillis

string (int64 format)

مطلوب. المدة التي يكون فيها كل رمز شريطي صالحًا