שאלות נפוצות על 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 לא תומך בהוספת תמונות אישיות לכרטיסים כי התקנות הנוכחיות קובעות שלכל הצרכנים יש זכות לבטל את ההסכמה לאיסוף או לעיבוד של מידע רגיש. אם נתונים רגישים (תמונות אישיות) כלולים באובייקט בעל ערך (ב-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?

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

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

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

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

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

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

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

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

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

לחיצה חכמה

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

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

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

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

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

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

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

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

פתרון בעיות

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

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

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

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

תמיכה ומשוב

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

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

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

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

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

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