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

חובה. שם התוכנית, למשל 'Adam's Apparel'. כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר, האפליקציה עשויה להציג שלוש נקודות אחרי 20 התווים הראשונים.
accountNameLabel

string

התווית של שם החשבון, למשל 'שם החבר'. האורך המקסימלי המומלץ הוא 15 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר.
accountIdLabel

string

תווית מזהה החשבון, למשל 'מזהה חבר'. האורך המקסימלי המומלץ הוא 15 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר.
rewardsTierLabel

string

התווית של רמת ההטבות, למשל 'רמת ההטבות'. האורך המקסימלי המומלץ הוא 9 תווים כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר.
rewardsTier

string

רמת התגמולים, למשל 'זהב' או 'פלטינה'. האורך המקסימלי המומלץ הוא 7 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר.
localizedProgramName

object (LocalizedString)

מחרוזות מתורגמות של programName. יכול להיות שבאפליקציה יוצג קו נטוי (ellipsis) אחרי 20 התווים הראשונים, כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר.
localizedAccountNameLabel

object (LocalizedString)

מחרוזות מתורגמות של accountNameLabel. האורך המקסימלי המומלץ הוא 15 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר.
localizedAccountIdLabel

object (LocalizedString)

מחרוזות מתורגמות של accountIdLabel. האורך המקסימלי המומלץ הוא 15 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר.
localizedRewardsTierLabel

object (LocalizedString)

מחרוזות מתורגמות עבור התגמוליםTierLabel. האורך המקסימלי המומלץ הוא 9 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר.
localizedRewardsTier

object (LocalizedString)

מחרוזות מתורגמות עבור התגמוליםTier. האורך המקסימלי המומלץ הוא 7 תווים כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר.
secondaryRewardsTierLabel

string

התווית המשנית של רמת ההטבות, למשל 'רמת ההטבות'.
localizedSecondaryRewardsTierLabel

object (LocalizedString)

מחרוזות מתורגמות של secondaryRewardsTierLabel.
secondaryRewardsTier

string

הדרגה המשנית של ההטבות, למשל 'זהב' או 'פלטינה'.
localizedSecondaryRewardsTier

object (LocalizedString)

מחרוזות מתורגמות של secondaryRewardsTier.
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)

ה-URI של דף הבית של האפליקציה. אכלוס ה-URI בשדה הזה מוביל לאותה התנהגות כמו אכלוס URI ב-linkModuleData (כשאובייקט עובר עיבוד, קישור לדף הבית מוצג באופן שבדרך כלל נחשב כ-LinkModuleData של האובייקט).
locations[]
(deprecated)

object (LatLongPoint)

הערה: בשלב הזה אין תמיכה בשדה הזה להפעלת התראות גיאוגרפיות.
reviewStatus

enum (ReviewStatus)

חובה. הסטטוס של הכיתה. אפשר להגדיר את השדה הזה לערך draft או לערך underReview באמצעות הוספה, תיקון או עדכון של קריאות ל-API. אחרי שמצב הבדיקה ישתנה מ-draft, לא תהיה אפשרות לחזור למצב draft.

כשהשיעור נמצא בפיתוח, צריך להשאיר את השדה הזה כ-draft. לא ניתן להשתמש בכיתה draft כדי ליצור אובייקט כלשהו.

צריך להגדיר את השדה הזה לערך underReview כשהכיתה מוכנה לשימוש. הפלטפורמה תגדיר את השדה הזה באופן אוטומטי לערך approved ואפשר יהיה להשתמש בו באופן מיידי כדי ליצור או להעביר אובייקטים.

כשמעדכנים כיתה שכבר approved, צריך להמשיך להגדיר את השדה הזה לערך underReview.
review

object (Review)

תגובות הבדיקה שמוגדרות על ידי הפלטפורמה כשכיתה מסומנת בסטטוס approved או rejected.
infoModuleData
(deprecated)

object (InfoModuleData)

הוצא משימוש. במקום זאת, צריך להשתמש ב-textModulesData.
imageModulesData[]

object (ImageModuleData)

נתוני מודול התמונה. המספר המקסימלי של השדות האלה שמוצג הוא 1 ברמת האובייקט ו-1 ברמת אובייקט המחלקה.
textModulesData[]

object (TextModuleData)

נתונים של מודול טקסט. אם גם נתונים של מודול טקסט מוגדרים בכיתה, יוצגו שניהם. המספר המקסימלי של השדות האלה שמוצגים הוא 10 מהאובייקט ו-10 מהכיתה.
redemptionIssuers[]

string (int64 format)

מזהה את מנפיקי השוברים שיכולים לממש את הכרטיס באמצעות 'הקשה חכמה'. מנפיקי שוברי המימוש מזוהים לפי מזהה המנפיק שלהם. למנפיקים של שוברי מימוש צריך להיות מוגדר לפחות מפתח אחד של Smart Tap.

גם השדה enableSmartTap ואחד מהשדות ברמת האובייקט smartTapRedemptionValue, ברקוד.value, oraccountId` צריכים להיות מוגדרים כראוי כדי שכרטיס יתמוך בהקשה חכמה.
countryCode

string

קוד המדינה שמשמש להצגת המדינה של הכרטיס (כשהמשתמש לא נמצא במדינה הזו), וגם להצגת תוכן מותאם כשהתוכן לא זמין באזור הגיאוגרפי של המשתמש.
heroImage

object (Image)

תמונת באנר אופציונלית שמוצגת בחזית הכרטיס. אם לא תהיה כותרת, לא יוצג דבר. התמונה תוצג ב-100% רוחב.
wordMark
(deprecated)

object (Image)

הוצא משימוש.
enableSmartTap

boolean

מזהה אם הכיתה הזו תומכת בהקשה חכמה. גם השדה redemptionIssuers ואחד מהשדות ברמת האובייקט smartTapRedemptionLevel, ברקוד.value, or accountId` צריכים להיות מוגדרים כראוי כדי שכרטיס יתמוך בהקשה חכמה.
hexBackgroundColor

string

צבע הרקע של הכרטיס. אם לא תגדירו צבע, המערכת תשתמש בצבע השולט בתמונת ה-Hero. אם לא תגדירו תמונה ראשית, המערכת תשתמש בצבע השולט בלוגו. הפורמט הוא #rrggbb, כאשר rrggbb הוא טריופל RGB ב-hex, למשל #ffcc00. אפשר גם להשתמש בקיצור של טריופל RGB, שהוא #rgb, למשל #fc0.
localizedIssuerName

object (LocalizedString)

מחרוזות מתורגמות של השדה issuerName. האורך המקסימלי המומלץ הוא 20 תווים, כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר.
multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

האפשרות הזו קובעת אם מספר משתמשים ומכשירים ישמרו את אותו אובייקט שמתייחס לכיתה הזו.
callbackOptions

object (CallbackOptions)

אפשרויות קריאה חוזרת (callback) שישמשו לקריאה חוזרת למנפיק בכל פעם שמשתמש הקצה שומר או מחק אובייקט מהסוג הזה. כל האובייקטים מהסוג הזה עומדים בדרישות להפעלת פונקציית ה-callback.
securityAnimation

object (SecurityAnimation)

מידע אופציונלי על אנימציית האבטחה. אם המדיניות הזו מוגדרת, תוצג אנימציית אבטחה בפרטי הכרטיס.
viewUnlockRequirement

enum (ViewUnlockRequirement)

בודקים את האפשרויות של דרישת הנעילה לכרטיס מועדון הלקוחות.
notifyPreference

enum (NotificationSettingsForUpdates)

אם עדכוני שדות של הכיתה הזו יפעילו התראות או לא. כשהערך מוגדר ל-NOTIFY, ננסה להפעיל התראה למשתמשים על עדכון השדה. ההתראות האלה יישלחו למשתמשים רק אם השדה נכלל ברשימת ההיתרים. אם לא יצוין ערך, לא תופעל התראה. ההגדרה הזו היא זמנית וצריך להגדיר אותה בכל בקשת PATCH או UPDATE, אחרת לא תופעל התראה.
valueAddedModuleData[]

object (ValueAddedModuleData)

נתונים אופציונליים של מודול עם ערך מוסף. עד עשרה תלמידים בכיתה. עבור כרטיס יוצגו רק 10, ותינתן עדיפות גבוהה יותר מהאובייקט.

DiscoverableProgram

מידע על האופן שבו ניתן לגלות כיתה וליצור מופע מתוך אפליקציית Android Pay. כדי לעשות זאת, מחפשים מועדון לקוחות או תוכנית של כרטיסי מתנה וסורקים או מזינים אותם באופן ידני.

ייצוג ב-JSON 
{
  "merchantSignupInfo": {
    object (DiscoverableProgramMerchantSignupInfo)
  },
  "merchantSigninInfo": {
    object (DiscoverableProgramMerchantSigninInfo)
  },
  "state": enum (State)
}
שדות
merchantSignupInfo

object (DiscoverableProgramMerchantSignupInfo)

מידע על האפשרות להירשם לתוכנית הזו ולהוסיף לה נכס דיגיטלי שאפשר לממש דרך אתר של מוכר. משמש כשהאפשרות MERCHANT_HOSTED_SIGNUP מופעלת.
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

טיפוסים בני מנייה (enum)
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 שאליה המשתמש יועבר לאתר הכניסה של המוכר.

מדינה

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED
TRUSTED_TESTERS מוצג רק לבוחנים שיש להם גישה לחשבון המנפיק.
trustedTesters

כינוי קודם של TRUSTED_TESTERS. הוצא משימוש.
LIVE גלוי לכולם.
live

כינוי מדור קודם של LIVE. הוצא משימוש.
DISABLED לא גלוי.
disabled

כינוי מדור קודם של DISABLED. הוצא משימוש.

שיטות

addmessage

 הוספת הודעה לקבוצת הלקוחות הנאמנים שמופיעה במזהה הקבוצה הנתון.

get

 הפונקציה מחזירה את רמת הלקוח במועדון הלקוחות לפי מזהה המחלקה שצוין.

insert

 הוספה של סיווג לקוחות נאמנים עם המזהה והמאפיינים שצוינו.

list

 הפונקציה מחזירה רשימה של כל רמות החברות במועדון הלקוחות למזהה מנפיק נתון.

patch

 עדכון של קטגוריית המועדון שמופיעה במזהה הקטגוריה שצוין.

update

 מעדכן את סיווג הנאמנות שאליו מפנה מזהה הכיתה הנתון.