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

איך מתחילים

מהו Google Wallet API?

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

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

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

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

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

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

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

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

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

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

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

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

פנייה לתמיכה

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

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

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

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

השימוש ב-GroupingID מקל על קיבוץ כרטיסים.

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

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

האם אפשר ליצור כרטיסים באצווה?

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

שאלות כלליות

מהי מגבלת הקצב של יצירת הבקשות שנשלחות אל Google Wallet API?

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

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

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

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

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

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

האם אפשר למחוק את מספרי חשבונות של מוכרים?

בשלב הזה, אי אפשר למחוק או להעביר לארכיון מספרי מוכרים דרך מסוף 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 מיוחד לכרטיסי SmartTap של Google?

המסוף חייב להיות תואם ל-SmartTap. רשימה של ספקים מורשים זמינה כאן.

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

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

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

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

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

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

פתרון בעיות

למה הגדרת הזמן שלי מציגה שעה לא נכונה לאירוע?

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

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

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

תמיכה ומשוב

איך יוצרים קשר עם התמיכה הטכנית?

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

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

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

איך אפשר לשלוח משוב על התיעוד?

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