المورد: GiftCardObject
تمثيل JSON |
---|
{ "kind": string, "classReference": { object ( |
الحقول | |
---|---|
kind |
تحدد نوع هذا المورد. القيمة: السلسلة الثابتة |
classReference |
نسخة من الحقول المكتسَبة من الفئة الرئيسية. يتم استرداد هذه الحقول أثناء GET. |
cardNumber |
مطلوبة. رقم البطاقة |
pin |
رقم التعريف الشخصي للبطاقة. |
balance |
الرصيد النقدي للبطاقة. |
balanceUpdateTime |
تاريخ ووقت آخر تعديل للرصيد. الإزاحة مطلوبة. إذا تم تعديل الرصيد ولم يتم توفير هذه السمة، سيستخدِم النظام الوقت الحالي تلقائيًا. |
eventNumber |
رقم حدث البطاقة، وهو حقل اختياري تستخدمه بعض بطاقات الهدايا. |
id |
مطلوبة. المعرّف الفريد لأحد العناصر. ويجب أن يكون هذا المعرّف فريدًا على مستوى كل العناصر التي تقدّمها جهة الإصدار. يجب أن تتبع هذه القيمة التنسيق issuer ID.identifier حيث تُصدر Google القيمة الأولى وتختار أنت الرقم الثاني. يجب أن لا يتضمن المعرّف الفريد سوى أحرف أبجدية رقمية أو "." أو "_" أو "-". |
classId |
مطلوبة. الفئة المرتبطة بهذا الكائن. ويجب أن تكون الفئة من نوع هذا الكائن نفسه، وأن تكون موجودة بالفعل، وأن تتم الموافقة عليها. يجب أن تكون أرقام تعريف الصفوف بالتنسيق issuer ID.identifier حيث تُصدر Google القيمة الأولى وتختار أنت الرقم الثاني. |
version |
منهي العمل به |
state |
مطلوبة. حالة العنصر يُستخدَم هذا الحقل لتحديد طريقة عرض عنصر في التطبيق. على سبيل المثال، يتم نقل عنصر |
barcode |
نوع الرمز الشريطي وقيمته |
messages[] |
مجموعة من الرسائل المعروضة في التطبيق. سيتلقّى جميع مستخدمي هذا العنصر الرسائل المرتبطة به. الحد الأقصى لعدد هذه الحقول هو 10. |
validTimeInterval |
وستكون الفترة الزمنية لهذا الكائن هي |
locations[] |
ملاحظة: هذا الحقل غير متاح حاليًا لتشغيل إشعارات الموقع الجغرافي. |
hasUsers |
يشير إلى ما إذا كان العنصر يحتوي على مستخدمين. يتم تعيين هذا الحقل بواسطة النظام الأساسي. |
smartTapRedemptionValue |
القيمة التي سيتم إرسالها إلى محطة دفع معتمَدة من خلال "الدفع الذكي" عبر تقنية NFC لهذا العنصر ويجب أيضًا إعداد الحقلَين |
hasLinkedDevice |
ما إذا كان هذا العنصر مرتبطًا حاليًا بجهاز واحد يتم ضبط هذا الحقل من خلال النظام الأساسي عندما يحفظ المستخدم العنصر ويربطه بجهازه. الجهاز مخصّص للاستخدام من قِبل شركاء محدّدين. يمكنك التواصل مع فريق الدعم للحصول على معلومات إضافية. |
disableExpirationNotification |
تشير هذه السمة إلى ما إذا كان يجب إيقاف الإشعارات بشكل صريح. في حال ضبط هذا الحقل على "صحيح" بغض النظر عن الحقل وفي الوقت الحالي، يمكن ضبط هذا الإعداد للعروض فقط. |
infoModuleData |
تمّ الإيقاف. استخدِم textModulesData بدلاً من ذلك. |
imageModulesData[] |
بيانات وحدة الصورة الحد الأقصى لعدد هذه الحقول المعروضة هو 1 من مستوى العنصر و1 لمستوى عنصر الفئة. |
textModulesData[] |
بيانات وحدة النص وإذا تمّ تحديد بيانات الوحدة النصية أيضًا في الفئة، سيتمّ عرض المجموعتَين. الحد الأقصى لعدد هذه الحقول المعروضة هو 10 من العنصر و10 من الفئة. |
linksModuleData |
بيانات وحدة الروابط. إذا تم تحديد بيانات وحدة الروابط أيضًا في الفئة، فسيتم عرض كليهما. |
appLinkData |
رابط اختياري للتطبيق أو الموقع الإلكتروني سيتم عرضه كزر في الجهة الأمامية من البطاقة في حال توفير AppLinkData للعنصر المقابل للفئة فقط، سيتم عرض AppLinkData. |
rotatingBarcode |
نوع الرمز الشريطي المتغيّر وقيمته |
heroImage |
صورة بانر اختيارية يتم عرضها على الجزء الأمامي من البطاقة. وفي حال عدم توفّر أي منها، سيتم عرض صورة الجزء الرئيسي للفئة، في حال توفّرها. إذا كانت صورة الجزء الرئيسي للفئة غير موجودة أيضًا، فلن يتم عرض أي شيء. |
groupingInfo |
معلومات تتحكّم في طريقة جمع البطاقات معًا. |
passConstraints |
تمرير قيود العنصر يشمل ذلك الحدّ من استخدام تقنية NFC ولقطات الشاشة. |
الطُرق |
|
---|---|
|
يؤدي هذا الإجراء إلى إضافة رسالة إلى عنصر بطاقة الهدايا المُشار إليه باستخدام رقم تعريف العنصر المحدّد. |
|
لعرض عنصر بطاقة الهدايا باستخدام رقم تعريف العنصر المحدّد. |
|
يتم إدراج عنصر بطاقة هدايا يتضمّن المعرّف والسمات المحدّدة. |
|
لعرض قائمة بكل عناصر بطاقات الهدايا لرقم تعريف جهة إصدار معيّن. |
|
تعمل هذه السياسة على تعديل عنصر بطاقة الهدايا المُشار إليه من خلال رقم تعريف العنصر المحدّد. |
|
تعمل هذه السياسة على تعديل عنصر بطاقة الهدايا المُشار إليه من خلال رقم تعريف العنصر المحدّد. |