שאלות נפוצות על Google Wallet API

תחילת העבודה

מהו Google Wallet API?

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

איך אפשר להגדיר את סביבת הפיתוח בהתאם לדרישות העסק ולמורכבות שלו?

בהמשך מופיעים מדריכים שאפשר להשתמש בהם כדי להגדיר סביבת פיתוח שמתאימה לרמות שונות של מורכבות עסקית ואבטחה. שימוש בכמה חשבונות שירות יכול לאפשר למפתחים ליצור סביבה לבדיקה (TEST) נפרדת מסביבת הייצור (PROD).

מורכבות ההגדרה הבסיסית

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

  • האפשרות הזו מאפשרת גישה מנוהלת באופן מרכזי באמצעות חשבון ראשי אחד עם אפס עד הרבה עסקים/מנפיקים משניים.
  • פרויקט אחד ב-Google Cloud.
  • פרטי כניסה לחשבון שירות אחד.
  • קבוצה אחת של משתמשים.

רמת המורכבות הממוצעת של ההגדרה

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

  • בעזרת האפשרות הזו, תוכלו לנהל גישה שמנוהלת באופן ריכוזי באמצעות חשבון ראשי אחד שכולל מספר רב של עסקים משניים.
  • 1 פרויקט ב-Google Cloud.
  • משתמשים נפרדים במסוף העסקי לכל מנפיק.
  • פרטי כניסה לחשבון שירות אחד או יותר.
    • פרטי כניסה אחד לכל עסק/מנפיק.
    • הרשאות גישה שונות לפרטי כניסה לכל עסק.

מורכבות של הגדרה מורכבת

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

  • האפשרות הזו מאפשרת גישה לניהול מרוכז באמצעות חשבון ראשי אחד עם הרבה עסקים משניים.
  • 1 עד הרבה פרויקטים ב-Google Cloud.
  • משתמשים נפרדים במסוף העסקי לכל מנפיק.
  • פרטי כניסה לחשבון שירות אחד או יותר.
    • פרטי כניסה אחד ל-PROD לכל עסק/מנפיק.
    • פרטי כניסה ל-DEV אחד לכל עסק/מנפיק.

פנייה לתמיכה

עבודה עם כרטיסים

איך מוחקים כיתות או אובייקטים?

בשלב הזה אי אפשר למחוק כיתות או אובייקטים מ-Google Wallet. עם זאת, המשתמשים יכולים לבטל את הקישור של אובייקטים מ-Google Wallet שלהם.

איך מקובצים כמה כרטיסים יחד?

בעזרת GroupingID אפשר לקבץ בקלות כרטיסים יחד.

איך מעדכנים רק חלק מהכרטיס?

לפעול בהתאם למדריך הביצועים שלנו כדי להבין איך לבצע עדכונים חלקיים באמצעות בקשות PATCH.

האם אפשר ליצור כרטיסים בכמות גדולה?

במדריך הביצועים מוסבר איך לבצע בקשות באצווה באמצעות ה-API.

שאלות כלליות

מהי המגבלה על קצב שליחת הבקשות ל-Google Wallet API?

קצב השיחות ל-Google Wallet API מוגבל ל-20 בקשות לשנייה.

למה אסור להוסיף תמונות אישיות לכרטיסים ב-Google Wallet?

ב-Google Wallet אין תמיכה בתמונות אישיות בכרטיסים, כי התקנות הקיימות קובעות שלכל הצרכנים יש זכות לסרב לאיסוף או לעיבוד של מידע רגיש. אם המידע הרגיש (תמונות אישיות) הוא חלק מהאובייקט בעל הערך (ב-JWT), יכולות להיות בעיות שקשורות לאירוח, שבהן הנתונים עשויים להיות גלויים לכולם, מחוץ להסכם ההסכמה המקורי. כדי לשמור על סודיות הנתונים, אסור להוסיף תמונות אישיות. אנחנו פועלים כדי להוסיף תמיכה בתמונות אישיות בעתיד.

אילו קודי שגיאה מוחזרים על ידי Google Wallet API?

רשימה של קודי שגיאה וחריגות שמוחזרים על ידי Google Wallet API מפורטת בקטע קודי שגיאה.

איך מפעילים התראות

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

לאורך התראה הופעל מאמרי עזרה
אירוע תזכורת עתידית 3 שעות לפני האירוע docs
כרטיס עלייה למטוס תזכורת עתידית 3 שעות לפני מועד הטיסה docs
כרטיס עלייה למטוס עדכון הכרטיס שינוי בטרמינל המוצא, בשער, בשעת העלייה למטוס או בשעת היציאה docs
כרטיס מבצע תזכורת לתפוגת התוקף 48 שעות לפני שתוקף כרטיס המבצע יפוג מסמכים
Generic תזכורת עתידית 24 שעות לפני ההתחלה של 'מרווח הזמן' docs
Generic תזכורת לתפוגת התוקף 48 שעות לפני סיום 'time internal' מסמכים

האם אפשר למחוק מספרי חשבון Merchant?

בשלב הזה לא ניתן למחוק מספרי חשבון של מוכרים או להעביר אותם לארכיון דרך מסוף Google Pay ו-Wallet.

איך משתמשים בתכונה 'קישור אפליקציות'?

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

האם יש תמיכה ב-Google Wallet בהגדרת אזורי הגנה גיאוגרפיים?

בשלב זה אין תמיכה בהגדרת אזורי הגנה גיאוגרפיים.

איך מגדירים מועדון לקוחות?

במדריך הזה מוסבר איך מגדירים תוכנית הרשמה ומועדון לקוחות.

איך שולחים ל-Google את הלוגו שלכם לכרטיסי נסיעה בתחבורה ציבורית?

כדי לשלוח ל-Google את הלוגו להוספה לרשימת ההיתרים, יש להשתמש בטופס הזה.

איך מטפלים בצורה נכונה בנתוני userProfile שמקודדים ב-Base64?

חשוב להשתמש בקידוד UTF-8 לאורך התהליך. מחרוזת ה-JSON מקודדת קודם ב-UTF-8 ולאחר מכן ב-android.util.Base64 עם האפשרויות NO_WRAP ו-URL_SAFE. הדבר תואם לסעיף 4 ב-RFC 3548.

איך יוצרים חשבונות מנפיקים באופן פרוגרמטי?

במדריך הזה מוסבר איך יוצרים חשבונות מנפיקים באמצעות ה-API.

תשלום חכם

האם צריך קורא NFC מיוחד לכרטיסים של Google SmartTap?

הוא חייב להיות טרמינל עם תמיכה ב-Smart Tap. כאן אפשר למצוא רשימה של ספקים מורשים.

איך אפשר להשתמש בכרטיסים באמצעות NFC?

כדי לאפשר את מימוש הכרטיס באמצעות Smart Tap, צריך לפעול לפי ההגדרה הזו.

אסימוני אינטרנט מסוג JSON (JWT)

האם יש כלים שמפשטים את ההטמעה של אסימוני JWT ואת ניפוי הבאגים שלהם?

כן, פלטפורמות כמו www.jwt.io מאפשרות לכם לפענח את האסימונים שלכם ולנפות באגים לגביהם במהלך תהליך הפיתוח, וכך מאפשרות לכם לאמת את התוכן שאתם שולחים. חשוב לדעת של-Google אין קשר לצדדים השלישיים האלה והיא לא ממליצה על אף אחד מהם באופן ספציפי.

אפשר ליצור מראש כיתות ואובייקטים באמצעות ה-API לפני יצירת הקישור לשמירת הכרטיס (JWT).

פתרון בעיות

למה השעה שמוצגת בהגדרת הזמן שלי שגויה ביחס לשעת האירוע?

השעה שמוצגת בכרטיס היא השעה המקומית של האירוע, עם הפרש לשעה שבה מתקיים האירוע.

הלוגו שלי לא מוצג בכרטיסים שיצרתי. מה יכולה להיות הבעיה?

  • קודם כול, צריך לוודא שהלוגו תואם להנחיות ושהוא שמור בפורמט PNG.
  • לוודא שהלוגו זמין בקלות ובאופן מהימן. אין להפנות לקובצי תמונה שעלולים לגרום לשגיאות 404. התמונות שלך צריכות להתארח במיקום HTTPS, כי אחרת הן לא יוצגו ב-Google Wallet.
  • מוודאים שכל שדות החובה שמסומנים כחובה ב-API מוגדרים בכרטיס.

תמיכה ומשוב

איך אפשר לפנות לתמיכה הטכנית?

לקבלת עזרה נוספת, אפשר לפנות לצוות התמיכה בלחיצה על הלחצן 'יצירת קשר עם התמיכה' בסרגל הצד שבו מוצגים השירותים של Google Pay ו-Wallet.

איך שולחים משוב על מוצר

כדי לשלוח משוב על המוצר, לוחצים על הלחצן 'שליחת משוב' ברבע השמאלי העליון של הדף באתר למפתחים ובוחרים באפשרות 'משוב על המוצר'. לאחר מכן, מתארים את המשוב באזור הטקסט ולוחצים על 'שליחה'.

איך שולחים משוב על מסמכים?

כדי לשלוח משוב על מסמכי העזרה, לוחצים על הלחצן Send Feedback (שליחת משוב) ברבע השמאלי העליון של דף האתר למפתחים ובוחרים באפשרות Documentation feedback (משוב על מסמכי העזרה). לאחר מכן, מתארים את המשוב באזור הטקסט ולוחצים על 'שליחה'.