משאב: GIFCardObject
ייצוג JSON |
---|
{ "kind": string, "classReference": { object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה |
classReference |
עותק של השדות שעברו בירושה של מחלקת ההורה. השדות האלה מאוחזרים במהלך אחזור נתונים (GET). |
cardNumber |
חובה. מספר הכרטיס. |
pin |
קוד האימות של הכרטיס. |
balance |
היתרה הכספית של הכרטיס. |
balanceUpdateTime |
התאריך והשעה שבהם היתרה עודכנה לאחרונה. חובה לציין היסט. אם היתרה מתעדכנת והנכס הזה לא סופק, ברירת המחדל של המערכת היא השעה הנוכחית. |
eventNumber |
מספר האירוע של הכרטיס, שדה אופציונלי שמשמש חלק מכרטיסי המתנה. |
id |
חובה. המזהה הייחודי של האובייקט. המזהה הזה חייב להיות ייחודי בכל האובייקטים של המנפיק. הערך צריך להיות בפורמט issuer ID.identifier כאשר הראשון הונפק על ידי Google והאחרון נבחר על ידך. המזהה הייחודי יכול לכלול רק תווים אלפאנומריים, '.', '_' או '-'. |
classId |
חובה. המחלקה שמשויכת לאובייקט הזה. הסיווג חייב להיות מאותו הסוג של האובייקט הזה, הוא כבר קיים וצריך לאשר אותו. מזהי הכיתות צריכים להיות בפורמט issuer ID.identifier כאשר הראשון הונפק על ידי Google והאחרון נבחר על ידך. |
version |
הוצא משימוש |
state |
חובה. מצב האובייקט. השדה הזה משמש לקביעת האופן שבו האובייקט יוצג באפליקציה. לדוגמה, אובייקט |
barcode |
סוג הברקוד והערך שלו. |
messages[] |
מערך של הודעות שמוצגות באפליקציה. כל המשתמשים באובייקט הזה יקבלו את ההודעות שמשויכות אליו. אפשר להוסיף עד 10 שדות כאלה. |
validTimeInterval |
תקופת הזמן של האובייקט הזה תהיה |
locations[] |
הערה: השדה הזה לא נתמך כרגע להפעלת התראות גיאוגרפיות. |
hasUsers |
מציין אם לאובייקט יש משתמשים. השדה הזה מוגדר על ידי הפלטפורמה. |
smartTapRedemptionValue |
הערך שיועבר למסוף שאושר על ידי Smart Tap דרך NFC עבור האובייקט הזה. גם השדות |
hasLinkedDevice |
האם האובייקט הזה מקושר כרגע למכשיר אחד. השדה הזה מוגדר על ידי הפלטפורמה כשמשתמש שומר את האובייקט, והוא מקשר אותו למכשיר שלו. מיועד לשימוש של שותפים נבחרים. לקבלת מידע נוסף, אפשר לפנות לתמיכה. |
disableExpirationNotification |
השדה הזה מציין אם צריך להסתיר את ההתראות באופן מפורש. אם השדה הזה מוגדר כ-True, ללא קשר לשדה נכון לעכשיו, אפשר להגדיר את זה רק למבצעים. |
infoModuleData |
הוצא משימוש. במקומו צריך להשתמש ב-textModulesData. |
imageModulesData[] |
נתונים של מודול התמונה. המספר המקסימלי של השדות האלה שמוצג הוא 1 ברמת האובייקט ו-1 ברמת אובייקט המחלקה. |
textModulesData[] |
נתונים של מודול הטקסט. אם גם נתוני מודול הטקסט מוגדרים במחלקה, שניהם יוצגו. מספר השדות המקסימלי שמוצג הוא 10 מהאובייקט ו-10 מהמחלקה. |
linksModuleData |
נתוני המודול. אם נתוני מודול של קישורים מוגדרים גם במחלקה, שניהם יוצגו. |
appLinkData |
קישור אופציונלי לאתר או לאפליקציה שיוצג כלחצן בחזית הכרטיס. אם תספקו את AppLinkData לאובייקט המתאים בלבד, יוצג AppLinkData. |
rotatingBarcode |
הסוג והערך של הברקוד המסתובב. |
heroImage |
תמונת באנר אופציונלית שמוצגת בחזית הכרטיס. אם אין כיתה, תוצג התמונה הראשית של הכיתה (אם יש כזו). אם גם התמונה הראשית (Hero) של הכיתה לא מופיעה, לא יוצג דבר. |
groupingInfo |
מידע שקובע איך הכרטיסים מקובצים יחד. |
passConstraints |
העברת האילוצים על האובייקט. כולל הגבלת התנהגויות של NFC וצילומי מסך. |
saveRestrictions |
הגבלות על האובייקט שצריך לאמת לפני שהמשתמש ינסה לשמור את הכרטיס. לתשומת ליבכם: ההגבלות האלה יחולו רק בזמן חיסכון בזמן. אם ההגבלות ישתנו אחרי שמשתמש ישמור את הכרטיס, ההגבלות החדשות לא יחולו על כרטיס שכבר נשמר. |
שיטות |
|
---|---|
|
הפונקציה מוסיפה הודעה לאובייקט של כרטיס המתנה שאליו מפנה מזהה האובייקט הנתון. |
|
הפונקציה מחזירה את אובייקט כרטיס המתנה עם מזהה האובייקט הנתון. |
|
הוספת אובייקט של כרטיס מתנה עם המזהה והמאפיינים הנתונים. |
|
מחזירה רשימה של כל האובייקטים של כרטיס המתנה לפי מזהה מנפיק נתון. |
|
מעדכן את אובייקט כרטיס המתנה שאליו מפנה מזהה האובייקט הנתון. |
|
מעדכן את אובייקט כרטיס המתנה שאליו מפנה מזהה האובייקט הנתון. |