משאב: EventTicketClass
ייצוג ב-JSON |
---|
{ "kind": string, "eventName": { object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב. ערך: המחרוזת הקבועה |
event |
חובה. שם האירוע, למשל 'LA Dodgers at SF Giants'. |
event |
מזהה האירוע. המזהה הזה צריך להיות ייחודי לכל אירוע בחשבון. השדה הזה משמש לקיבוץ כרטיסים אם המשתמש שמר כמה כרטיסים לאותו אירוע. הוא יכול להכיל עד 64 תווים. אם תספקו את הערך הזה, הקיבוץ יהיה יציב. חשוב להיזהר מהתנגשויות לא מכוונות כדי להימנע מקיבוץ של כרטיסים שלא צריך לקבץ. אם משתמשים רק במחלקה אחת לכל אירוע, אפשר פשוט להגדיר את הערך אם לא תספקו את הפרמטר הזה, הפלטפורמה תנסה להשתמש בנתונים אחרים כדי לקבץ את הכרטיסים (יכול להיות שהתוצאה תהיה לא יציבה). |
logo |
תמונת הלוגו של הכרטיס. התמונה הזו מוצגת בתצוגת פרטי הכרטיס של האפליקציה. |
venue |
פרטי מקום האירוע. |
date |
פרטי התאריך והשעה של האירוע. |
confirmation |
התווית שתשמש להצגת הערך של קוד האימות ( אסור להגדיר גם את |
custom |
תווית בהתאמה אישית לשימוש בערך של קוד האישור ( לא ניתן להגדיר גם את |
seat |
התווית שבה צריך להשתמש בערך המושב ( אסור להגדיר גם את |
custom |
תווית בהתאמה אישית לשימוש בערך המושב ( אסור להגדיר גם את |
row |
התווית שתשמש לערך השורה ( אסור להגדיר גם את |
custom |
תווית בהתאמה אישית לשימוש בערך השורה ( אסור להגדיר גם את |
section |
התווית שישמש לערך הקטע ( אסור להגדיר גם את |
custom |
תווית בהתאמה אישית לשימוש בערך הקטע ( אסור להגדיר גם את |
gate |
התווית שבה יש להשתמש עבור ערך השער ( לא ניתן להגדיר גם את |
custom |
תווית בהתאמה אישית לשימוש בערך השער ( אסור להגדיר גם את |
fine |
האותיות הקטנות, התנאים או ההגבלות של הכרטיס. |
class |
פרטי התבנית לגבי אופן הצגת הכיתה. אם לא תגדירו את השדה, Google תשתמש בקבוצת שדות ברירת מחדל להצגה. |
id |
חובה. המזהה הייחודי של הכיתה. המזהה הזה חייב להיות ייחודי בכל המחלקות של המנפיק. הערך צריך להיות בפורמט issuer ID.identifier, כאשר המזהה הראשון מונפק על ידי Google והשני נבחר על ידכם. המזהה הייחודי צריך לכלול רק תווים אלפאנומריים, נקודה (.), קו תחתון (_) או מקף (-). |
version |
הוצא משימוש |
issuer |
חובה. שם המנפיק. האורך המקסימלי המומלץ הוא 20 תווים, כדי שהמחרוזת תוצג במלואה במסכים קטנים יותר. |
messages[] |
מערך של הודעות שמוצגות באפליקציה. כל המשתמשים של האובייקט הזה יקבלו את ההודעות שמשויכות אליו. המספר המקסימלי של השדות האלה הוא 10. |
allowMultipleUsersPerObject |
הוצא משימוש. במקום זאת, אתם צריכים להשתמש ב- |
homepage |
ה-URI של דף הבית של האפליקציה. אכלוס ה-URI בשדה הזה מוביל לאותה התנהגות כמו אכלוס URI ב-linkModuleData (כשאובייקט עובר עיבוד, קישור לדף הבית מוצג באופן שבדרך כלל נחשב כ-LinkModuleData של האובייקט). |
locations[] |
הערה: השדה הזה לא נתמך כרגע להפעלת התראות גיאוגרפיות. |
review |
חובה. הסטטוס של הכיתה. אפשר להגדיר את השדה הזה לערך צריך להשאיר את השדה הזה בשדה צריך להגדיר את השדה הזה ל- כשמעדכנים כיתה שכבר מוגדרת כ- |
review |
התגובות לבדיקה שהוגדרו על ידי הפלטפורמה כשכיתה מסומנת כ- |
infoModuleData |
הוצא משימוש. במקום זאת, צריך להשתמש ב-textModulesData. |
image |
נתוני מודול התמונה. המספר המקסימלי של השדות האלה שמוצגים הוא 1 ברמת האובייקט ו-1 ברמת אובייקט הכיתה. |
text |
נתונים של מודול טקסט. אם גם נתוני מודול הטקסט מוגדרים במחלקה, שניהם יוצגו. מספר השדות המקסימלי שמוצג הוא 10 מהאובייקט ו-10 מהמחלקה. |
links |
נתוני המודול. אם הנתונים של מודול הקישורים מוגדרים גם באובייקט, יוצגו שניהם. |
redemption |
מזהה את מנפיקי השוברים שיכולים לממש את הכרטיס באמצעות 'הקשה חכמה'. מנפיקי מימושים מזוהים לפי מזהה המנפיק שלהם. למנפיקי המימוש צריך להגדיר לפחות מפתח 'תשלום חכם' אחד. גם השדות |
country |
קוד המדינה שמשמש להצגת המדינה של הכרטיס (כשהמשתמש לא נמצא במדינה הזו), וגם להצגת תוכן מותאם כשהתוכן לא זמין באזור הגיאוגרפי של המשתמש. |
hero |
תמונה אופציונלית של באנר שמוצגת בחזית הכרטיס. אם לא תהיה כותרת, לא יוצג דבר. התמונה תוצג ב-100% רוחב. |
wordMark |
הוצא משימוש. |
enable |
מזהה אם הכיתה הזו תומכת בהקשה חכמה. כדי שהכרטיס יתמוך בתכונה 'הקשה חכמה', צריך להגדיר גם את השדות |
hex |
צבע הרקע של הכרטיס. אם לא תגדירו צבע, המערכת תשתמש בצבע השולט בתמונת ה-Hero. אם לא תגדירו תמונה ראשית, המערכת תשתמש בצבע השולט בלוגו. הפורמט הוא #rrggbb, כאשר rrggbb הוא טריופל RGB ב-hex, למשל |
localized |
מחרוזות מתורגמות של השדה issuerName. האורך המקסימלי המומלץ הוא 20 תווים, כדי שהמחרוזת תוצג במלואה במסכים קטנים יותר. |
multiple |
מזהה אם מספר משתמשים ומכשירים ישמרו את אותו אובייקט שמפנה למחלקה הזו. |
callback |
אפשרויות קריאה חוזרת (callback) שישמשו לקריאה חוזרת למנפיק בכל פעם שמשתמש הקצה שומר או מחק אובייקט מהסוג הזה. כל האובייקטים במחלקה הזו עומדים בדרישות להתקשרות חזרה. |
security |
מידע אופציונלי על אנימציית האבטחה. אם המדיניות הזו מוגדרת, תוצג אנימציית אבטחה בפרטי הכרטיס. |
view |
בודקים את האפשרויות של דרישת הנעילה לכרטיס לאירוע. |
wide |
הלוגו הרחב של הכרטיס. אם תספקו תמונה, היא תוצג במקום הלוגו בפינה הימנית העליונה של תצוגת הכרטיס. |
notify |
אם עדכוני שדות של הכיתה הזו יפעילו התראות או לא. אם הערך שמוגדר הוא NOTIFY, ננסה לשלוח למשתמשים התראה על עדכון שדות. ההתראות האלה יישלחו למשתמשים רק אם השדה נכלל ברשימת ההיתרים. אם לא יצוין ערך, לא תופעל התראה. ההגדרה הזו זמנית וצריך להגדיר אותה בכל בקשת PATCH או עדכון, אחרת לא תופעל התראה. |
app |
קישור אופציונלי לאפליקציה או לאתר שיוצג כלחצן בחזית הכרטיס. אם מציינים את AppLinkData לאובייקט המתאים, המערכת תשתמש בו במקום זאת. |
value |
נתונים אופציונליים של מודול ערך מוסף. עד עשרה תלמידים בכיתה. לגבי כרטיס, יוצגו רק עשרה, והעדיפות תהיה לנתונים מהעצם. |
EventVenue
ייצוג ב-JSON |
---|
{ "kind": string, "name": { object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב. ערך: המחרוזת הקבועה |
name |
שם המקום, למשל 'AT&T Park'. זהו שדה חובה. |
address |
הכתובת של מקום האירוע, למשל: '24 Willie Mays Plaza\nSan Francisco, CA 94107'. שורות הכתובת מופרדות באמצעות תווים של פיד שורות ( זהו שדה חובה. |
EventDateTime
ייצוג ב-JSON |
---|
{ "kind": string, "doorsOpen": string, "start": string, "end": string, "doorsOpenLabel": enum ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב. ערך: המחרוזת הקבועה |
doors |
התאריך/השעה שבהם הדלתות יפתחו במקום. זהו תאריך/שעה בפורמט מורחב של ISO 8601, עם או בלי עיכוב. אפשר לציין את הזמן בדיוק של ננו-שנייה. אפשר לציין את הזזות הזמן ברמת דיוק של שניות (למרות שזזות זמן בשניות לא נכללות ב-ISO 8601). לדוגמה: הערך של הערך של הערך של החלק של התאריך/השעה ללא הקיזוז נחשב ל"תאריך/שעה מקומיים". התאריך הזה צריך להיות התאריך והשעה המקומיים של המקום. לדוגמה, אם האירוע מתרחש בשעה ה-20 ב-5 ביוני 2018 במקום האירוע, החלק של התאריך/השעה המקומיים צריך להיות בלי פרטי היסט, יכול להיות שחלק מהתכונות המתקדמות לא יהיו זמינות. |
start |
התאריך והשעה שבהם האירוע מתחיל. אם האירוע נמשך כמה ימים, צריך לציין את התאריך והשעה של ההתחלה ביום הראשון. זהו תאריך/שעה בפורמט מורחב של ISO 8601, עם או בלי עיכוב. אפשר לציין את הזמן בדיוק של ננו-שנייה. ניתן לציין היסט בדיוק בשניות (למרות ששניות היסט הן חלק מתקן ISO 8601). לדוגמה: הערך של הערך של הערך של החלק של התאריך/השעה ללא הקיזוז נחשב ל"תאריך/שעה מקומיים". התאריך הזה צריך להיות התאריך והשעה המקומיים של המקום. לדוגמה, אם האירוע מתרחש בשעה ה-20 ב-5 ביוני 2018 במקום האירוע, החלק של התאריך/השעה המקומיים צריך להיות בלי פרטי היסט, יכול להיות שחלק מהתכונות המתקדמות לא יהיו זמינות. |
end |
התאריך והשעה שבהם האירוע יסתיים. אם האירוע נמשך כמה ימים, צריך לבחור תאריך/שעת הסיום ביום האחרון. זהו תאריך/שעה בפורמט מורחב של ISO 8601, עם או בלי עיכוב. אפשר לציין את הזמן בדיוק של ננו-שנייה. ניתן לציין היסט בדיוק בשניות (למרות ששניות היסט הן חלק מתקן ISO 8601). לדוגמה: הערך של הערך של הערך של החלק של התאריך/השעה ללא הקיזוז נחשב ל"תאריך/שעה מקומיים". התאריך הזה צריך להיות התאריך והשעה המקומיים של המקום. לדוגמה, אם האירוע מתרחש בשעה ה-20 ב-5 ביוני 2018 במקום האירוע, החלק של התאריך/השעה המקומיים צריך להיות בלי מידע על היסט, יכול להיות שחלק מהתכונות המתקדמות לא יהיו זמינות. |
doors |
התווית שתשמש לערך של הדלתות הפתוחות ( אסור להגדיר גם את |
custom |
תווית מותאמת אישית לשימוש בערך הפתוח של הדלתות ( לא ניתן להגדיר גם את |
DoorsOpenLabel
טיפוסים בני מנייה (enum) | |
---|---|
DOORS_OPEN_LABEL_UNSPECIFIED |
|
DOORS_OPEN |
|
doorsOpen |
כינוי מדור קודם של |
GATES_OPEN |
|
gatesOpen |
כינוי מדור קודם של |
ConfirmationCodeLabel
טיפוסים בני מנייה (enum) | |
---|---|
CONFIRMATION_CODE_LABEL_UNSPECIFIED |
|
CONFIRMATION_CODE |
|
confirmationCode |
כינוי מדור קודם של |
CONFIRMATION_NUMBER |
|
confirmationNumber |
כינוי קודם של |
ORDER_NUMBER |
|
orderNumber |
כינוי מדור קודם של |
RESERVATION_NUMBER |
|
reservationNumber |
כינוי מדור קודם של |
SeatLabel
טיפוסים בני מנייה (enum) | |
---|---|
SEAT_LABEL_UNSPECIFIED |
|
SEAT |
|
seat |
כינוי מדור קודם של |
RowLabel
טיפוסים בני מנייה (enum) | |
---|---|
ROW_LABEL_UNSPECIFIED |
|
ROW |
|
row |
כינוי קודם של |
SectionLabel
טיפוסים בני מנייה (enum) | |
---|---|
SECTION_LABEL_UNSPECIFIED |
|
SECTION |
|
section |
כינוי מדור קודם של |
THEATER |
|
theater |
כינוי קודם של |
GateLabel
טיפוסים בני מנייה (enum) | |
---|---|
GATE_LABEL_UNSPECIFIED |
|
GATE |
|
gate |
כינוי מדור קודם של |
DOOR |
|
door |
כינוי מדור קודם של |
ENTRANCE |
|
entrance |
כינוי קודם של |
שיטות |
|
---|---|
|
הפונקציה מוסיפה הודעה לסיווג הכרטיס לאירוע שאליו מפנה מזהה הכיתה הנתון. |
|
הפונקציה מחזירה את מחלקת הכרטיס לאירוע עם מזהה הכיתה הנתון. |
|
מוסיפה מחלקה של כרטיס לאירוע עם המזהה והמאפיינים הנתונים. |
|
הפונקציה מחזירה רשימה של כל הכיתות של כרטיסים לאירועים למזהה מנפיק נתון. |
|
הקוד מעדכן את קטגוריית הכרטיסים לאירועים שמשויכת למזהה הקטגוריה שצוין. |
|
הקוד מעדכן את קטגוריית הכרטיסים לאירועים שמשויכת למזהה הקטגוריה שצוין. |