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_*}. تُستخدم Totpparams في الفهرس 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

مطلوب. التاريخ/الوقت الذي يكون فيه الرمز الشريطي الأول صالحًا. سيتم تدوير الرموز الشريطية باستخدام levelMillis المحددة في 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)

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