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

תחילת העבודה

מה זה Google Wallet API?

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

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

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

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

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

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

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

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

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

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

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

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

פנה לתמיכה

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

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

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

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

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

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

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

Can I batch create passes?

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

שאלות כלליות

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

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

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

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

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

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

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

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

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

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

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

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

איך משתמשים בתכונה Applinking?

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

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

אין כרגע תמיכה בגדר וירטואלית.

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

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

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

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

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

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

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

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

לחיצה חכמה

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

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

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

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

אסימוני JWT (‏JSON Web Tokens)

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

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

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

פתרון בעיות

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

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

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

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

תמיכה ומשוב

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

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

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

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

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

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