المورد: GenericObject
عنصر عام
تمثيل JSON |
---|
{ "genericType": enum ( |
الحقول | |
---|---|
genericType |
يجب تحديد |
cardTitle |
مطلوبة. عنوان البطاقة. ويكون عادةً اسم النشاط التجاري، مثل "XXX Gym" أو "AAA Insurance". هذا الحقل مطلوب ويظهر في صف العنوان في أعلى البطاقة. |
subheader |
تصنيف عنوان البطاقة، مثل الموقع الجغرافي الذي يمكن استخدامها فيه تظهر أعلى العنوان مباشرةً في صف العنوان في عرض تفاصيل البطاقة. |
header |
مطلوبة. عنوان البطاقة، مثل "قسيمة خصم% 50" أو "بطاقة المكتبة" أو "قسيمة" هذا الحقل مطلوب ويظهر في صف العنوان في عرض تفاصيل البطاقة. |
logo |
صورة شعار البطاقة يتم عرض هذه الصورة في عرض تفاصيل البطاقة في أعلى يمين الشاشة، وفي عرض القائمة/الصورة المصغّرة. في حال عدم توفّر الشعار، سيظهر الحرف الأول من |
hexBackgroundColor |
لون خلفية البطاقة إذا لم يتم تعيين، يتم استخدام اللون السائد لصورة الجزء الرئيسي، وإذا لم يتم تعيين صورة الجزء الرئيسي، يتم استخدام اللون السائد للشعار وإذا لم يتم تعيين الشعار، فستختار Google اللون. |
notifications |
إعدادات الإشعارات التي تم تفعيلها لهذا العنصر |
id |
مطلوبة. المعرّف الفريد لأحد العناصر. ويجب أن يكون هذا المعرّف فريدًا على مستوى كل العناصر التي تقدّمها جهة الإصدار. يجب أن تتّبع هذه القيمة التنسيق |
classId |
مطلوبة. الفئة المرتبطة بهذا الكائن. ويجب أن تكون الفئة من نوع هذا الكائن نفسه، وأن تكون موجودة بالفعل، وأن تتم الموافقة عليها. يجب أن تكون معرّفات الصفوف بالتنسيق |
barcode |
نوع الرمز الشريطي وقيمته إذا كانت البطاقة لا تحتوي على رمز شريطي، يمكننا السماح لجهة الإصدار بضبط Barcode.alternate_text وعرض ذلك فقط. |
heroImage |
يتم عرض صورة البانر على الجزء الأمامي من البطاقة إذا كانت موجودة. سيتم عرض الصورة بنسبة عرض تبلغ 100%. |
validTimeInterval |
الفترة الزمنية التي سيتم اعتبار هذا الكائن صالحة أو قابلة للاستخدام. وعند انقضاء الفترة الزمنية، سيتم اعتبار العنصر منتهي الصلاحية، ما سيؤثر في عرض المحتوى على أجهزة المستخدم. |
imageModulesData[] |
بيانات وحدة الصورة لن يتم عرض سوى صورة واحدة من الفئة وأخرى من مستوى العنصر عند ضبطهما. |
textModulesData[] |
بيانات وحدة النص إذا تم تحديد |
linksModuleData |
بيانات وحدة الروابط. إذا تم تحديد |
appLinkData |
رابط اختياري للتطبيق أو الموقع الإلكتروني سيتم عرضه كزر في الجهة الأمامية من البطاقة في حال توفير AppLinkData للعنصر المقابل للفئة فقط، سيتم عرض AppLinkData. |
groupingInfo |
معلومات تتحكّم في طريقة جمع البطاقات معًا. |
smartTapRedemptionValue |
القيمة التي سيتم إرسالها إلى محطة دفع معتمَدة من خلال "الدفع الذكي" عبر تقنية NFC لهذا العنصر ويجب أيضًا إعداد الحقلَين |
rotatingBarcode |
إعدادات/تفاصيل الرمز الشريطي الدوّار |
state |
حالة العنصر يُستخدَم هذا الحقل لتحديد طريقة عرض عنصر في التطبيق. على سبيل المثال، يتم نقل عنصر |
hasUsers |
يشير إلى ما إذا كان العنصر يحتوي على مستخدمين. يتم تعيين هذا الحقل بواسطة النظام الأساسي. |
passConstraints |
تمرير قيود العنصر يشمل ذلك الحدّ من استخدام تقنية NFC ولقطات الشاشة. |
wideLogo |
الشعار العريض للبطاقة. عند توفير الشعار، سيتم استخدامه بدلاً من الشعار في الجزء العلوي الأيمن من طريقة عرض البطاقة. |
GenericType
نوع البطاقة العامة.
عمليات التعداد | |
---|---|
GENERIC_TYPE_UNSPECIFIED |
لم يتم تحديد نوع عام. |
GENERIC_SEASON_PASS |
تذكرة الموسم |
GENERIC_UTILITY_BILLS |
فواتير خدمات |
GENERIC_PARKING_PASS |
بطاقة ركن |
GENERIC_VOUCHER |
قسيمة |
GENERIC_GYM_MEMBERSHIP |
بطاقات عضوية صالة الألعاب الرياضية |
GENERIC_LIBRARY_MEMBERSHIP |
بطاقات عضوية في المكتبة |
GENERIC_RESERVATIONS |
الحجوزات |
GENERIC_AUTO_INSURANCE |
بطاقات التأمين على السيارات |
GENERIC_HOME_INSURANCE |
بطاقات التأمين على المنازل |
GENERIC_ENTRY_TICKET |
تذاكر الدخول |
GENERIC_RECEIPT |
الإيصالات |
GENERIC_OTHER |
نوع آخر |
الإشعارات
يشير إلى ما إذا كان العنصر بحاجة إلى تفعيل الإشعارات. يمكن استخدام إشعار واحد فقط من ExpiryNotification/SentNotification. يكون للقاعدة expiryNotification
الأولوية على upcomingNotification
. أو بعبارةٍ أخرى، في حال ضبط expiryNotification
، سنتجاهل الحقل upcomingNotification
.
تمثيل JSON |
---|
{ "expiryNotification": { object ( |
الحقول | |
---|---|
expiryNotification |
سيظهر إشعار في وقت محدد قبل انتهاء صلاحية البطاقة. |
upcomingNotification |
وسيظهر إشعار في الوقت المحدّد قبل أن تصبح البطاقة قابلة للاستخدام. |
ExpiryNotification
يشير هذا الرمز إلى أنّ جهة إصدار البطاقة تريد من "محفظة Google" إرسال إشعارات انتهاء صلاحية قبل يومَين من تاريخ انتهاء صلاحية البطاقة.
تمثيل JSON |
---|
{ "enableNotification": boolean } |
الحقول | |
---|---|
enableNotification |
يشير هذا العمود إلى ما إذا كان يجب تفعيل إشعار انتهاء الصلاحية في العنصر. |
UpcomingNotification
يشير هذا الرمز إلى أنّ جهة الإصدار تريد من "محفظة Google" إرسال إشعار قادم بشأن صلاحية البطاقة قبل يوم واحد من أن تصبح البطاقة صالحة/قابلة للاستخدام.
تمثيل JSON |
---|
{ "enableNotification": boolean } |
الحقول | |
---|---|
enableNotification |
يشير هذا العمود إلى ما إذا كان يجب تفعيل الإشعارات القادمة على العنصر. |
الطُرق |
|
---|---|
|
تتم إضافة رسالة إلى العنصر العام الذي يشير إليه رقم تعريف العنصر المحدّد. |
|
لعرض الكائن العام برقم تعريف الكائن المحدّد. |
|
لإدراج كائن عام برقم التعريف والخصائص المحددة. |
|
تعرض قائمة بكل العناصر العامة لرقم تعريف جهة إصدار معيّن. |
|
يعدِّل العنصر العام المشار إليه من خلال رقم تعريف العنصر المحدّد. |
|
يعدِّل العنصر العام المشار إليه من خلال رقم تعريف العنصر المحدّد. |