REST Resource: loyaltyobject

المرجع: LoyaltyObject

تمثيل JSON 
{
  "kind": string,
  "classReference": {
    object (LoyaltyClass)
  },
  "accountName": string,
  "accountId": string,
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "linkedOfferIds": [
    string
  ],
  "secondaryLoyaltyPoints": {
    object (LoyaltyPoints)
  },
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
الحقول
kind
(deprecated)

string

يحدد نوع هذا المورد. القيمة: السلسلة الثابتة "walletobjects#loyaltyObject".
classReference

object (LoyaltyClass)

نسخة من الحقول المكتسَبة لفئة المصدر يتم استرداد هذه الحقول أثناء طلب GET.
accountName

string

اسم صاحب حساب الولاء، مثل "عادل كمال" الحد الأقصى المقترَح هو 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
accountId

string

معرّف حساب الولاء. الحد الأقصى المقترَح هو 20 حرفًا.
loyaltyPoints

object (LoyaltyPoints)

تصنيف نقاط المكافآت في برنامج الولاء ورصيده ونوعه
linkedOfferIds[]

string

قائمة بعناصر العروض المرتبطة ببطاقة الولاء هذه يجب أن تكون عناصر العرض متوفّرة.

يجب أن تتبع أرقام تعريف كائنات العرض بالتنسيق issuer ID.identifier حيث تُصدر Google المعرّف الأول ويمكنك اختيار المعرّف الثاني.
secondaryLoyaltyPoints

object (LoyaltyPoints)

تصنيف نقاط المكافآت الثانوية ورصيده ونوعه تظهر بالإضافة إلى نقاط الولاء الأساسية.
id

string

مطلوب. المعرّف الفريد للعنصر ويجب أن يكون هذا المعرّف فريدًا في كل العناصر من جهة الإصدار. يجب أن تتبع هذه القيمة التنسيق issuer ID.identifier حيث تُصدر Google المعرّف الأول ويمكنك اختيار المعرّف الثاني. يجب أن يتضمّن المعرّف الفريد أحرفًا أبجدية رقمية فقط أو النقطة أو الشرطة السفلية أو الواصلة.
classId

string

مطلوب. الصفّ المرتبط بهذا الكائن يجب أن يكون الصف من النوع نفسه مثل هذا العنصر، ويجب أن يكون متوفّرًا، ويجب الموافقة عليه.

يجب أن تتبع أرقام تعريف الصفوف التنسيق issuer ID.identifier حيث تُصدر Google المعرّف الأول ويمكنك اختيار المعرّف الثاني.
version
(deprecated)

string (int64 format)

منهي العمل به
state

enum (State)

مطلوب. حالة العنصر يُستخدَم هذا الحقل لتحديد كيفية عرض عنصر في التطبيق. على سبيل المثال، يتم نقل عنصر inactive إلى قسم "البطاقات المنتهية الصلاحية".
barcode

object (Barcode)

نوع الرمز الشريطي وقيمته
messages[]

object (Message)

صفيف من الرسائل المعروضة في التطبيق. سيتلقّى جميع مستخدمي هذا العنصر الرسائل المرتبطة به. الحد الأقصى لعدد هذه الحقول هو 10.
validTimeInterval

object (TimeInterval)

الفترة الزمنية التي سيكون هذا الكائن فيها active ويمكن استخدام الكائن. سيتم تغيير حالة العنصر إلى expired بعد انقضاء هذه الفترة الزمنية.
locations[]
(deprecated)

object (LatLongPoint)

ملاحظة: لا يمكن حاليًا استخدام هذا الحقل لتشغيل الإشعارات الجغرافية.
hasUsers

boolean

تشير إلى ما إذا كان العنصر يتضمّن مستخدمين. تضبط المنصة هذا الحقل.
smartTapRedemptionValue

string

القيمة التي سيتم إرسالها إلى محطة دفع معتمَدة من Smart Tap عبر NFC لهذا العنصر. يجب أيضًا ضبط الحقلين enableSmartTap وredemptionIssuers على مستوى الفئة بشكل صحيح لكي تتيح البطاقة ميزة "النقرة الذكية". لا يمكن استخدام سوى أحرف ASCII.

في حال ترك هذه القيمة بدون ضبط، ولكن تم إعداد حقلَي مستوى الفئة enableSmartTap وredemptionIssuers بشكل صحيح، يتم استخدام الحقلَين barcode.value أو accountId كحقلَين احتياطيَين في حال توفُّرهما.
hasLinkedDevice

boolean

ما إذا كان هذا العنصر مرتبطًا حاليًا بجهاز واحد يضبط النظام الأساسي هذا الحقل عندما يحفظ المستخدم العنصر ويربطه بجهازه. مخصّص للاستخدام من قِبل شركاء محدّدين. يُرجى التواصل مع فريق الدعم للحصول على معلومات إضافية.
disableExpirationNotification

boolean

يشير إلى ما إذا كان يجب إيقاف الإشعارات صراحةً. في حال ضبط هذا الحقل على "صحيح"، سيتم حظر إرسال إشعارات انتهاء الصلاحية إلى المستخدم بغض النظر عن حقل messages. يتم ضبط هذا الحقل تلقائيًا على false.

في الوقت الحالي، لا يمكن ضبط هذا الإعداد إلا للعروض.
infoModuleData

object (InfoModuleData)

تمّ الإيقاف. استخدِم textModulesData بدلاً من ذلك.
imageModulesData[]

object (ImageModuleData)

بيانات وحدة الصور إنّ الحدّ الأقصى لعدد هذه الحقول المعروضة هو 1 من مستوى العنصر و1 لمستوى عنصر الفئة.
textModulesData[]

object (TextModuleData)

بيانات وحدة النصوص إذا تمّ أيضًا تحديد بيانات وحدة النص في الفئة، سيتم عرض كليهما. الحد الأقصى لعدد هذه الحقول المعروضة هو 10 حقول من العنصر و10 حقول من الفئة.
rotatingBarcode

object (RotatingBarcode)

نوع الرمز الشريطي المتغيّر وقيمته
heroImage

object (Image)

صورة بانر اختيارية تظهر على الجهة الأمامية من البطاقة في حال عدم توفّر أيّ منها، سيتم عرض صورة رئيسية للفئة، إذا كانت متوفّرة. إذا لم تكن صورة العرض للصف متوفّرة أيضًا، لن يتم عرض أي محتوى.
groupingInfo

object (GroupingInfo)

المعلومات التي تتحكّم في كيفية تجميع البطاقات معًا
passConstraints

object (PassConstraints)

نقْل القيود للعنصر ويشمل ذلك الحدّ من سلوكيات NFC ولقطات الشاشة.
saveRestrictions

object (SaveRestrictions)

القيود المفروضة على العنصر التي يجب التحقّق منها قبل أن يحاول المستخدم حفظ البطاقة يُرجى العلم أنّ هذه القيود لن يتم تطبيقها إلا خلال وقت الحفظ. إذا تغيّرت القيود بعد أن يحفظ المستخدم البطاقة، لن يتم تطبيق القيود الجديدة على البطاقة التي سبق حفظها.
linkedObjectIds[]

string

تمثل ‎linkedObjectIds قائمة بعناصر أخرى، مثل تذكرة حضور فعالية أو بطاقة ولاء أو عرض أو عنصر عام أو بطاقة هدايا أو بطاقة نقل عام أو بطاقة صعود إلى الطائرة، والتي يجب إرفاقها تلقائيًا بعنصر الولاء هذا. إذا حفظ مستخدم بطاقة الولاء هذه، سيتم تلقائيًا إرسال معرّفات linkedObjectIds هذه إلى محفظة المستخدم (ما لم يوقف الإعداد لتلقّي البطاقات المرتبطة هذه).

تأكَّد من أنّه سبق إدراج العناصر المتوفّرة في linkedObjectIds، وإلا ستتعذّر عمليات الاستدعاء. بعد ربط العناصر، لا يمكن إلغاء ربطها. لا يمكنك ربط عناصر تابعة لمُصدِر آخر. هناك حدّ لعدد العناصر التي يمكن ربطها بكائن واحد. بعد بلوغ الحدّ الأقصى، سيتم تجاهل الكائنات المرتبطة الجديدة في المكالمة بدون إشعار.

يجب أن تتّبع معرّفات العناصر التنسيق issuer ID.identifier حيث تُصدر Google المعرّف الأول ويكون المعرّف الثاني من اختيارك.
notifyPreference

enum (NotificationSettingsForUpdates)

ما إذا كان يجب أن تؤدي تعديلات الحقل على هذا العنصر إلى تشغيل الإشعارات أم لا. عند ضبط القيمة على NOTIFY (إشعار)، سنحاول إرسال إشعار إلى المستخدمين بشأن تعديل الحقل. ولن يتم إرسال هذه الإشعارات إلى المستخدمين إلا إذا كان الحقل جزءًا من قائمة مسموح بها. في حال الضبط على DO_NOT_NOTIFY أو NOTIFICATION_SETTINGS_UNSPECIFIED، لن يتم تشغيل أي إشعار. هذا الإعداد مؤقت ويجب ضبطه مع كل طلب PATCH أو UPDATE، وإلا لن يتم تشغيل إشعار.
valueAddedModuleData[]

object (ValueAddedModuleData)

بيانات وحدة القيمة المضافة الاختيارية. عشرة عناصر كحد أقصى على الجسم

LoyaltyPoints

تمثيل JSON 
{
  "label": string,
  "balance": {
    object (LoyaltyPointsBalance)
  },
  "localizedLabel": {
    object (LocalizedString)
  }
}
الحقول
label

string

تصنيف نقاط الولاء، مثل "النقاط" الحد الأقصى الموصى به للطول هو 9 أحرف.
balance

object (LoyaltyPointsBalance)

رصيد نقاط الولاء الخاص بصاحب الحساب، مثل "500" أو "10.00 دولار أمريكي" الحد الأقصى المقترَح هو 7 أحرف. هذا حقل مطلوب من loyaltyPoints وsecondaryLoyaltyPoints.
localizedLabel

object (LocalizedString)

سلاسل مترجمة للتصنيف. الحد الأقصى المقترَح هو 9 أحرف.

LoyaltyPointsBalance

تمثيل JSON 
{
  "string": string,
  "int": integer,
  "double": number,
  "money": {
    object (Money)
  }
}
الحقول
string

string

تنسيق السلسلة للرصيد يجب تعبئة نوع واحد فقط من هذه الأنواع الفرعية (string, int, مزدوج، المال).
int

integer

الشكل الصحيح لرصيد. يجب ملء نوع فرعي واحد فقط من هذه الأنواع الفرعية (string أو int أو double أو money).
double

number

النموذج المزدوج للتوازن. يجب ملء نوع فرعي واحد فقط من هذه الأنواع الفرعية (string أو int أو double أو money).
money

object (Money)

الشكل المالي للرصيد. يجب ملء نوع فرعي واحد فقط من هذه الأنواع الفرعية (string أو int أو double أو money).

الطُرق

addmessage

 تُضيف رسالة إلى عنصر الولاء الذي يشير إليه معرّف العنصر المحدّد.

get

 تعرِض هذه الدالة عنصر الولاء الذي يحمل رقم تعريف العنصر المحدّد.

insert

 تُدرج عنصرًا للولاء باستخدام المعرّف والسمات المحدّدة.

list

 عرض قائمة بجميع عناصر برنامج الولاء لرقم تعريف جهة إصدار معيّن

modifylinkedofferobjects

 تعديل عناصر العروض المرتبطة لكائن الولاء باستخدام المعرّف المحدّد

patch

 تعديل عنصر الولاء المُشار إليه بمعرّف العنصر المحدّد

update

 لتعديل عنصر الولاء الذي يشير إليه رقم تعريف العنصر المحدّد.