REST Resource: loyaltyclass

المرجع: LoyaltyClass

تمثيل JSON 
{
  "kind": string,
  "programName": string,
  "programLogo": {
    object (Image)
  },
  "accountNameLabel": string,
  "accountIdLabel": string,
  "rewardsTierLabel": string,
  "rewardsTier": string,
  "localizedProgramName": {
    object (LocalizedString)
  },
  "localizedAccountNameLabel": {
    object (LocalizedString)
  },
  "localizedAccountIdLabel": {
    object (LocalizedString)
  },
  "localizedRewardsTierLabel": {
    object (LocalizedString)
  },
  "localizedRewardsTier": {
    object (LocalizedString)
  },
  "secondaryRewardsTierLabel": string,
  "localizedSecondaryRewardsTierLabel": {
    object (LocalizedString)
  },
  "secondaryRewardsTier": string,
  "localizedSecondaryRewardsTier": {
    object (LocalizedString)
  },
  "discoverableProgram": {
    object (DiscoverableProgram)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideProgramLogo": {
    object (Image)
  },
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
الحقول
kind
(deprecated)

string

لتحديد نوع المورد. القيمة: السلسلة الثابتة "walletobjects#loyaltyClass".
programName

string

مطلوب. اسم البرنامج، مثل "ملابس آدم". قد يعرض التطبيق علامة شرطة منقطة بعد أول 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
accountNameLabel

string

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

string

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

string

تصنيف مستوى المكافآت، مثل "مستوى المكافآت" يبلغ الحد الأقصى المقترَح للطول 9 أحرف لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
rewardsTier

string

فئة المكافآت، مثل "الذهبي" أو "البلاتيني" الحد الأقصى المقترَح للطول هو 7 أحرف لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
localizedProgramName

object (LocalizedString)

سلاسل النصوص المترجَمة لـ programName قد يعرض التطبيق علامة حذف بعد أول 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
localizedAccountNameLabel

object (LocalizedString)

سلاسل النصوص المترجَمة لسمة accountNameLabel الحد الأقصى المقترَح هو 15 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
localizedAccountIdLabel

object (LocalizedString)

سلاسل مترجمة لـ accountIdLabel الحد الأقصى المقترَح هو 15 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
localizedRewardsTierLabel

object (LocalizedString)

سلاسل أحرف مترجَمة لعنصر rewardsTierLabel الحد الأقصى المقترَح هو 9 أحرف لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
localizedRewardsTier

object (LocalizedString)

سلاسل مترجمة لمكافآت Tier الحد الأقصى المقترَح هو 7 أحرف لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
secondaryRewardsTierLabel

string

تصنيف مستوى المكافآت الثانوية، مثل "مستوى المكافآت"
localizedSecondaryRewardsTierLabel

object (LocalizedString)

سلاسل مترجمة لمَعلمةsecondary RewardsTierLabel
secondaryRewardsTier

string

مستوى المكافآت الثانوية، مثل "الذهبي" أو "البلاتيني"
localizedSecondaryRewardsTier

object (LocalizedString)

سلاسل النصوص المترجَمة لرتبة المكافآت الثانوية
discoverableProgram

object (DiscoverableProgram)

معلومات حول كيفية العثور على الصف وإنشاء مثيل منه من داخل تطبيق Google Pay
classTemplateInfo

object (ClassTemplateInfo)

تمثّل هذه السمة معلومات النموذج حول الطريقة التي يجب عرض بها الصف. وفي حال عدم ضبطها، ستستعين Google بمجموعة تلقائية من الحقول لعرضها.
id

string

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

string (int64 format)

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

string

مطلوب. اسم جهة الإصدار الحد الأقصى المقترَح هو 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
messages[]

object (Message)

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

boolean

تمّ الإيقاف. استخدِم multipleDevicesAndHoldersAllowedStatus بدلاً من ذلك.
homepageUri

object (Uri)

معرّف الموارد المنتظم للصفحة الرئيسية لتطبيقك. يؤدي ملء معرّف الموارد المنتظم في هذا الحقل إلى السلوك نفسه تمامًا الذي يؤدي إليه ملء معرّف الموارد المنتظم في linksModuleData (عند عرض عنصر، يظهر رابط إلى الصفحة الرئيسية في ما يُعتقد عادةً أنّه قسم linksModuleData من العنصر).
locations[]
(deprecated)

object (LatLongPoint)

ملاحظة: هذا الحقل غير متاح حاليًا لتشغيل الإشعارات الجغرافية.
reviewStatus

enum (ReviewStatus)

مطلوب. حالة الفئة. يمكن ضبط هذا الحقل على draft أو underReview باستخدام طلبات بيانات الإدراج أو التعديل أو التحديث من واجهة برمجة التطبيقات. بعد تغيير حالة المراجعة من draft، قد لا تتمكّن من تغييرها مرة أخرى إلى draft.

يجب ضبط هذا الحقل على draft عندما يكون الصف قيد التطوير. لا يمكن استخدام فئة draft لإنشاء أي عنصر.

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

عند تعديل فئة approved، يجب مواصلة ضبط هذا الحقل على underReview.
review

object (Review)

تشير هذه السمة إلى تعليقات المراجعة التي ضبطتها المنصّة عند وضع علامة approved أو rejected على صف دراسي.
infoModuleData
(deprecated)

object (InfoModuleData)

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

object (ImageModuleData)

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

object (TextModuleData)

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

string (int64 format)

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

يجب أيضًا إعداد الحقل enableSmartTap وأحد الحقلين smartTapRedemptionValue وbarcode.value, oraccountId على مستوى العنصر بشكل صحيح لكي تتيح البطاقة استخدام ميزة "النقرة الذكية".
countryCode

string

رمز البلد المستخدَم لعرض بلد البطاقة (عندما لا يكون المستخدم في ذلك البلد)، بالإضافة إلى عرض محتوى مترجَم عندما لا يتوفّر المحتوى بلغة المستخدم
heroImage

object (Image)

صورة بانر اختيارية معروضة في الجهة الأمامية من البطاقة. وفي حال عدم توفّر أي منها، لن يتم عرض أي شيء. سيتم عرض الصورة بعرض ‎100%.
wordMark
(deprecated)

object (Image)

تمّ الإيقاف.
enableSmartTap

boolean

لتحديد ما إذا كانت هذه الفئة تتيح ميزة "النقرة الذكية". يجب أيضًا إعداد الحقل redemptionIssuers وأحد الحقلين smartTapRedemptionLevel وbarcode.value, or accountId على مستوى العنصر بشكل صحيح لكي تتيح البطاقة استخدام ميزة "النقرة الذكية".
hexBackgroundColor

string

لون خلفية البطاقة. إذا لم يتم ضبطه، يتم استخدام اللون السائد لصورة العرض، وإذا لم يتم ضبط صورة عرض، يتم استخدام اللون السائد للشعار. يكون التنسيق على النحو التالي: #rrggbb حيث يكون rrggbb مجموعة RGB سداسية عشرية، مثل #ffcc00. يمكنك أيضًا استخدام النسخة المختصرة للنموذج الثلاثي أحمر أخضر أزرق، وهو رقم rgb، مثل #fc0.
localizedIssuerName

object (LocalizedString)

سلاسل مُترجَمة لسمة issuerName يبلغ الحد الأقصى المقترَح للطول 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.
multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

تحدِّد هذه السياسة ما إذا كان العديد من المستخدمين والأجهزة سيحفظ العنصر نفسه الذي يشير إلى هذه الفئة.
callbackOptions

object (CallbackOptions)

خيارات معاودة الاتصال التي سيتم استخدامها لمعاودة الاتصال بجهة الإصدار عند كل عملية حفظ أو حذف لعنصر في هذه الفئة من قِبل المستخدم النهائي جميع عناصر هذا الفئة مؤهَّلة لمعاودة الاتصال.
securityAnimation

object (SecurityAnimation)

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

enum (ViewUnlockRequirement)

الاطّلاع على خيارات "متطلبات فتح القفل" الخاصة ببطاقة الولاء
notifyPreference

enum (NotificationSettingsForUpdates)

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

object (ValueAddedModuleData)

بيانات اختيارية لمكوّنات القيمة المضافة عشرة كحد أقصى في الصف. بالنسبة إلى البطاقة، سيتم عرض عشرة عناصر فقط، مع إعطاء الأولوية للعناصر الواردة من الكائن.

DiscoverableProgram

معلومات عن كيفية اكتشاف فئة وإنشاء مثيل لها من داخل تطبيق Android Pay. ويتم ذلك من خلال البحث عن برنامج ولاء أو بطاقة هدايا ومسح رمز الاستجابة السريعة أو إدخاله يدويًا.

تمثيل JSON 
{
  "merchantSignupInfo": {
    object (DiscoverableProgramMerchantSignupInfo)
  },
  "merchantSigninInfo": {
    object (DiscoverableProgramMerchantSigninInfo)
  },
  "state": enum (State)
}
الحقول
merchantSignupInfo

object (DiscoverableProgramMerchantSignupInfo)

معلومات حول إمكانية الاشتراك في هذا البرنامج وإضافة قيمة له من خلال موقع التاجر الإلكتروني يتم استخدامه عندما يتم تفعيل MERCHANT_HOSTED_خي.
merchantSigninInfo

object (DiscoverableProgramMerchantSigninInfo)

معلومات حول إمكانية تسجيل الدخول إلى هذا البرنامج وإضافة قيمة إليه من خلال الموقع الإلكتروني للتاجر يُستخدَم هذا المَعلمة عندما يكون MERCHANT_HOSTED_SIGNIN مفعَّلاً.
state

enum (State)

حالة ظهور البرنامج القابل للاكتشاف

DiscoverableProgramMerchantSignupInfo

معلومات حول خطوات الاشتراك التي يستضيفها التاجر في أحد البرامج

تمثيل JSON 
{
  "signupWebsite": {
    object (Uri)
  },
  "signupSharedDatas": [
    enum (SharedDataType)
  ]
}
الحقول
signupWebsite

object (Uri)

عنوان URL المطلوب توجيه المستخدم إليه والخاص بالموقع الإلكتروني الذي يستخدمه التاجر للاشتراك.
signupSharedDatas[]

enum (SharedDataType)

بيانات المستخدمين التي يتم إرسالها في طلب POST إلى عنوان URL للموقع الإلكتروني الخاص بالاشتراك ويتم ترميز هذه المعلومات ثم مشاركتها حتى يتمكّن موقع التاجر الإلكتروني من ملء الحقول المستخدَمة لتسجيل المستخدم في البرنامج القابل للاكتشاف مسبقًا.

SharedDataType

عمليات التعداد
SHARED_DATA_TYPE_UNSPECIFIED
FIRST_NAME
LAST_NAME
STREET_ADDRESS حقل عنوان سطر واحد
ADDRESS_LINE_1 حقول العناوين متعددة الأسطر
ADDRESS_LINE_2
ADDRESS_LINE_3
CITY
STATE
ZIPCODE
COUNTRY
EMAIL
PHONE

DiscoverableProgramMerchantSigninInfo

معلومات حول مسار تسجيل الدخول الذي يستضيفه التاجر لبرنامج معيّن

تمثيل JSON 
{
  "signinWebsite": {
    object (Uri)
  }
}
الحقول
signinWebsite

object (Uri)

عنوان URL لتوجيه المستخدم إلى موقع تسجيل الدخول الخاص بالتاجر.

الحالة

عمليات التعداد
STATE_UNSPECIFIED
TRUSTED_TESTERS لا تظهر هذه القيمة إلا للمختبِرين الذين يمكنهم الوصول إلى حساب المُصدِر.
trustedTesters

الاسم المستعار القديم لـ TRUSTED_TESTERS. تمّ الإيقاف.
LIVE مرئية للجميع.
live

الاسم المستعار القديم لـ LIVE. تمّ الإيقاف.
DISABLED غير مرئي
disabled

الاسم المستعار القديم لـ DISABLED. تمّ الإيقاف.

الطُرق

addmessage

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

get

 لعرض فئة الولاء التي تحمل رقم تعريف الفئة المحدّد.

insert

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

list

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

patch

 تعديل فئة الولاء التي يشير إليها رقم تعريف الفئة المحدّد

update

 تعديل فئة الولاء التي يشير إليها رقم تعريف الفئة المحدّد