المورد: loyaltyObject
تمثيل JSON |
---|
{ "kind": string, "classReference": { object ( |
الحقول | |
---|---|
kind |
تحدد نوع هذا المورد. القيمة: السلسلة الثابتة |
classReference |
نسخة من الحقول المكتسَبة من الفئة الرئيسية. يتم استرداد هذه الحقول أثناء GET. |
accountName |
اسم صاحب حساب الولاء، مثل "John Smith". الحد الأقصى المقترَح للطول هو 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا. |
accountId |
معرّف حساب الولاء. الحد الأقصى المقترَح للطول هو 20 حرفًا. |
loyaltyPoints |
تصنيف نقاط مكافأة الولاء والرصيد ونوعها. |
linkedOfferIds[] |
قائمة بعناصر العروض المرتبطة ببطاقة الولاء هذه. يجب أن تكون عناصر العرض متوفّرة مسبقًا. يجب أن تكون أرقام تعريف عناصر العرض بالتنسيق issuer ID.identifier حيث تُصدر Google القيمة الأولى وتختار أنت الرقم الثاني. |
secondaryLoyaltyPoints |
تمثّل هذه السمة تصنيف نقاط مكافأة الولاء الثانوية والرصيد ونوعها. يظهر هذا الخيار بالإضافة إلى نقاط الولاء الأساسية. |
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 ولقطات الشاشة. |
LoyaltyPoints
تمثيل JSON |
---|
{ "label": string, "balance": { object ( |
الحقول | |
---|---|
label |
تصنيف نقاط الولاء، مثل "النقاط" الحد الأقصى المقترَح للطول هو 9 أحرف. |
balance |
رصيد نقاط الولاء لصاحب الحساب، مثل "500" أو "10.00 دولار أمريكي" الحد الأقصى المقترَح للطول هو 7 أحرف. يجب ملء هذا الحقل لكل من |
localizedLabel |
سلاسل مترجمة للتصنيف. الحد الأقصى المقترَح للطول هو 9 أحرف. |
LoyaltyPointsBalance
تمثيل JSON |
---|
{
"string": string,
"int": integer,
"double": number,
"money": {
object ( |
الحقول | |
---|---|
string |
شكل السلسلة للتوازن. يجب تعبئة نوع واحد فقط من هذه الأنواع الفرعية (سلسلة أو int أو مزدوج أو أموال). |
int |
تمثّل هذه السمة صيغة العدد الصحيح للرصيد. يجب تعبئة نوع واحد فقط من هذه الأنواع الفرعية (سلسلة أو int أو مزدوج أو أموال). |
double |
تمثّل هذه السمة الطريقة المزدوجة للتوازن. يجب تعبئة نوع واحد فقط من هذه الأنواع الفرعية (سلسلة أو int أو مزدوج أو أموال). |
money |
شكل الرصيد المالي. يجب تعبئة نوع واحد فقط من هذه الأنواع الفرعية (سلسلة أو int أو مزدوج أو أموال). |
الطُرق |
|
---|---|
|
يضيف هذا الزر رسالة إلى عنصر الولاء المشار إليه من خلال رقم تعريف العنصر المحدّد. |
|
لعرض كائن الولاء باستخدام رقم تعريف الكائن المحدد. |
|
يدرج عنصر الولاء مع المعرّف والمواقع المحددة. |
|
تعرض قائمة بكل عناصر الولاء لمعرّف جهة إصدار معيّن. |
|
يُعدّل عناصر العرض المرتبط لعنصر الولاء باستخدام المعرّف المحدّد. |
|
تُعدِّل عنصر الولاء المشار إليه من خلال رقم تعريف العنصر المحدّد. |
|
تُعدِّل عنصر الولاء المشار إليه من خلال رقم تعريف العنصر المحدّد. |