משאב: LoyaltyClass
ייצוג JSON |
---|
{ "kind": string, "programName": string, "programLogo": { object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב. ערך: המחרוזת הקבועה |
program |
חובה. שם התוכנית, למשל 'Adam's Apparel'. יכול להיות שבאפליקציה יוצג קו נטוי (ellipsis) אחרי 20 התווים הראשונים, כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר. |
program |
חובה. הלוגו של מועדון הלקוחות או של החברה. הלוגו הזה מוצג גם בתצוגת הפרטים וגם בתצוגת הרשימה של האפליקציה. |
account |
התווית של שם החשבון, למשל 'שם החבר'. האורך המקסימלי המומלץ הוא 15 תווים כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר. |
account |
התווית של מספר החשבון, למשל 'מזהה חבר'. האורך המקסימלי המומלץ הוא 15 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר. |
rewards |
התווית של רמת ההטבות, למשל 'רמת ההטבות'. האורך המקסימלי המומלץ הוא 9 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר. |
rewards |
רמת התגמולים, למשל 'זהב' או 'פלטינה'. האורך המקסימלי המומלץ הוא 7 תווים כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר. |
localized |
מחרוזות מתורגמות של programName. יכול להיות שבאפליקציה יוצג קו נטוי (ellipsis) אחרי 20 התווים הראשונים, כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר. |
localized |
מחרוזות מתורגמות של accountNameLabel. האורך המקסימלי המומלץ הוא 15 תווים כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר. |
localized |
מחרוזות מתורגמות עבור accountIdLabel. האורך המקסימלי המומלץ הוא 15 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר. |
localized |
מחרוזות מתורגמות של rewardsTierLabel. האורך המקסימלי המומלץ הוא 9 תווים כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר. |
localized |
מחרוזות מתורגמות של rewardsTier. האורך המקסימלי המומלץ הוא 7 תווים, כדי שהמחרוזת תופיע במלואה במסכים קטנים יותר. |
secondary |
התווית המשנית של רמת ההטבות, למשל 'רמת ההטבות'. |
localized |
מחרוזות מתורגמות עבור התגמולים המשניים של RewardsTierLabel. |
secondary |
הדרגה המשנית של ההטבות, למשל 'זהב' או 'פלטינה'. |
localized |
מחרוזות מתורגמות של secondaryRewardsTier. |
discoverable |
מידע על האופן שבו אפשר לגלות את הכיתה וליצור אותה מתוך אפליקציית Google Pay. |
class |
פרטי התבנית לגבי אופן הצגת הכיתה. אם המדיניות לא מוגדרת, Google תשתמש בקבוצת ברירת מחדל של שדות להצגה. |
id |
חובה. המזהה הייחודי של הכיתה. המזהה הזה חייב להיות ייחודי בכל הכיתות של מנפיק. הערך צריך להיות בפורמט issuer ID.identifier כאשר הראשון הונפק על ידי Google והאחרון נבחר על ידך. המזהה הייחודי צריך לכלול רק תווים אלפאנומריים, נקודה (.), קו תחתון (_) או מקף (-). |
version |
הוצא משימוש |
issuer |
חובה. שם המנפיק. האורך המקסימלי המומלץ הוא 20 תווים, כדי להבטיח שהמחרוזת המלאה תוצג במסכים קטנים יותר. |
messages[] |
מערך של הודעות שמוצגות באפליקציה. כל המשתמשים של האובייקט הזה יקבלו את ההודעות שמשויכות אליו. אפשר להוסיף עד 10 שדות כאלה. |
allowMultipleUsersPerObject |
הוצא משימוש. במקום זאת, אתם צריכים להשתמש ב- |
homepage |
ה-URI של דף הבית של האפליקציה. האכלוס של ה-URI בשדה הזה גורם לאותה התנהגות בדיוק כמו האכלוס של ה-URI ב-linksModuleData (כשאובייקט מנוהל, קישור לדף הבית מוצג במקום שנחשב בדרך כלל לקטע linksModuleData של האובייקט). |
locations[] |
הערה: השדה הזה לא נתמך כרגע להפעלת התראות גיאוגרפיות. |
review |
חובה. הסטטוס של הכיתה. אפשר להגדיר את השדה הזה לערך כשהשיעור נמצא בפיתוח, צריך להשאיר את השדה הזה כ- צריך להגדיר את השדה הזה ל- כשמעדכנים כיתה שכבר מוגדרת כ- |
review |
תגובות הבדיקה שמוגדרות על ידי הפלטפורמה כשכיתה מסומנת בסטטוס |
infoModuleData |
הוצא משימוש. במקום זאת, צריך להשתמש ב-textModulesData. |
image |
נתוני מודול התמונה. המספר המקסימלי של השדות האלה שמוצגים הוא 1 ברמת האובייקט ו-1 ברמת אובייקט הכיתה. |
text |
נתונים של מודול טקסט. אם גם נתוני מודול הטקסט מוגדרים במחלקה, שניהם יוצגו. המספר המקסימלי של השדות האלה שמוצגים הוא 10 מהאובייקט ו-10 מהכיתה. |
links |
נתוני המודול 'קישורים'. אם הנתונים של מודול הקישורים מוגדרים גם באובייקט, יוצגו שניהם. |
redemption |
מזהה את מנפיקי השוברים שיכולים לממש את הכרטיס באמצעות 'הקשה חכמה'. מנפיקי שוברי המימוש מזוהים לפי מזהה המנפיק שלהם. למנפיקי המימוש צריך להגדיר לפחות מפתח 'תשלום חכם' אחד. כדי שהכרטיס יתמוך בתכונה 'הקשה חכמה', צריך להגדיר גם את השדה |
country |
קוד המדינה שמשמש להצגת המדינה שבה נמצא הכרטיס (כשהמשתמש לא נמצא במדינה הזו), וגם להצגת תוכן שמותאם לשוק המקומי כשהתוכן לא זמין באזור של המשתמש. |
hero |
תמונה אופציונלית של באנר שמוצגת בחזית הכרטיס. אם לא קיים דבר, לא יוצג דבר. התמונה תוצג ב-100% רוחב. |
wordMark |
הוצא משימוש. |
enable |
מזהה אם הכיתה הזו תומכת בהקשה חכמה. גם השדה |
hex |
צבע הרקע של הכרטיס. אם לא מגדירים את הצבע הדומיננטי של התמונה הראשית (Hero), משתמשים בתמונה הראשית (Hero) אם לא הגדרתם את הצבע הדומיננטי של הלוגו. הפורמט הוא #rrggbb, כאשר rrggbb הוא שלשה הקסדצימלית של RGB, למשל |
localized |
מחרוזות מתורגמות של השדה issuerName. האורך המקסימלי המומלץ הוא 20 תווים, כדי שהמחרוזת תוצג במלואה במסכים קטנים יותר. |
multiple |
האפשרות הזו קובעת אם מספר משתמשים ומכשירים ישמרו את אותו אובייקט שמתייחס לכיתה הזו. |
callback |
אפשרויות קריאה חוזרת (callback) שישמשו לקריאה חוזרת למנפיק בכל פעם שמשתמש הקצה שומר או מחק אובייקט מהסוג הזה. כל האובייקטים מהסוג הזה עומדים בדרישות להפעלת פונקציית ה-callback. |
security |
מידע אופציונלי על אנימציית האבטחה. אם ההגדרה הזו מוגדרת, תופעל אנימציית אבטחה בפרטי הכרטיס. |
view |
בודקים את האפשרויות של דרישת הנעילה לכרטיס מועדון הלקוחות. |
wide |
הלוגו הרחב של מועדון הלקוחות או החברה. אם תספקו לוגו, הוא ישמש במקום הלוגו של התוכנית בפינה הימנית העליונה של תצוגת הכרטיס. |
notify |
אם עדכוני שדות של הכיתה הזו יפעילו התראות או לא. כשהערך מוגדר ל-NOTIFY, ננסה להפעיל התראה למשתמשים על עדכון השדה. ההתראות האלה יישלחו למשתמשים רק אם השדה נכלל ברשימת ההיתרים. אם לא יצוין ערך, לא תופעל התראה. ההגדרה הזו היא זמנית וצריך להגדיר אותה בכל בקשת PATCH או UPDATE, אחרת לא תופעל התראה. |
app |
קישור אופציונלי לאפליקציה או לאתר שיוצג כלחצן בחזית הכרטיס. אם מציינים את AppLinkData לאובייקט המתאים, המערכת תשתמש בו במקום זאת. |
value |
נתונים אופציונליים של מודול עם ערך מוסף. עד עשרה תלמידים בכיתה. עבור כרטיס יוצגו רק 10, ותינתן עדיפות גבוהה יותר מהאובייקט. |
DiscoverableProgram
מידע על האופן שבו ניתן לגלות כיתה וליצור מופע מתוך אפליקציית Android Pay. כדי לעשות זאת, מחפשים מועדון לקוחות או תוכנית של כרטיסי מתנה וסורקים או מזינים אותם באופן ידני.
ייצוג ב-JSON |
---|
{ "merchantSignupInfo": { object ( |
שדות | |
---|---|
merchant |
מידע על האפשרות להירשם לתוכנית הזו ולהוסיף לה נכס דיגיטלי שאפשר לממש דרך אתר של מוכר. משמש כשהאפשרות MERCHANT_HOSTED_SIGNUP מופעלת. |
merchant |
מידע על היכולת להיכנס לתוכנית הזו ולהוסיף ערך חשוב דרך אתר של מוכר. משמש כשהאפשרות MERCHANT_HOSTED_SIGNIN מופעלת. |
state |
מצב החשיפה של התוכנית שגלויה לכולם. |
DiscoverableProgramMerchantSignupInfo
מידע על תהליך ההרשמה לתוכנית שמתארח באתר של המוכר.
ייצוג ב-JSON |
---|
{ "signupWebsite": { object ( |
שדות | |
---|---|
signup |
כתובת ה-URL שאליה צריך להפנות את המשתמש עבור אתר ההרשמה של המוֹכר. |
signup |
נתוני משתמשים שנשלחים בבקשת POST לכתובת ה-URL של אתר ההרשמה. המידע הזה מקודד ולאחר מכן משותף, כדי שאתר המוכר יוכל למלא מראש שדות שמשמשים להרשמה של המשתמש לתוכנית הגלויה. |
DiscoverableProgramMerchantSigninInfo
מידע על תהליך הכניסה לאתר שמתארח אצל המוכר עבור מועדון.
ייצוג ב-JSON |
---|
{
"signinWebsite": {
object ( |
שדות | |
---|---|
signin |
כתובת ה-URL שאליה יש להפנות את המשתמש עבור אתר הכניסה של המוכר. |
מדינה
טיפוסים בני מנייה (enum) | |
---|---|
STATE_UNSPECIFIED |
|
TRUSTED_TESTERS |
מוצג רק לבוחנים שיש להם גישה לחשבון המנפיק. |
trustedTesters |
כינוי מדור קודם של |
LIVE |
גלוי לכולם. |
live |
כינוי מדור קודם של |
DISABLED |
לא גלוי. |
disabled |
כינוי מדור קודם של |
שיטות |
|
---|---|
|
הוספת הודעה לקבוצת הלקוחות הנאמנים שמופיעה במזהה הקבוצה הנתון. |
|
הפונקציה מחזירה את רמת הלקוח במועדון הלקוחות לפי מזהה המחלקה שצוין. |
|
מוסיפה מחלקת מועדון לקוחות עם המזהה והמאפיינים הנתונים. |
|
מחזירה רשימה של כל סיווגי הנאמנות לפי מזהה מנפיק נתון. |
|
מעדכן את סיווג הנאמנות שאליו מפנה מזהה הכיתה הנתון. |
|
עדכון של קטגוריית המועדון שמופיעה במזהה הקטגוריה שצוין. |