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

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

مطلوبة. التاريخ/الوقت الذي يكون فيه الرمز الشريطي الأول صالحًا. سيتم تدوير الرموز الشريطية باستخدام destinationMillis المحدد في RotatingBarcodeValueInfo للكائن.

هذا تنسيق تاريخ/وقت بتنسيق ISO 8601 موسّع، مع إزاحة. يمكن تحديد الوقت بدقة تصل إلى نانو ثانية. يمكن تحديد الإزاحة بدقة بالثواني (على الرغم من أن ثواني الإزاحة ليست جزءًا من ISO 8601).

مثال:

بعد 12 نيسان (أبريل) 1985، ستستغرق عملية 1985-04-12T23:20:50.52Z 20 دقيقة و50.52 ثانية بعد الساعة 23 من شهر نيسان (أبريل) 1985.

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

values[]

string

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

periodMillis

string (int64 format)

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