הכרטיס הגנרי זמין למקרים שבהם תרחיש השימוש שלכם לא מתאים לאף אחד מסוגי הכרטיסים האחרים שהוגדרו מראש. בניגוד לכרטיסים אחרים שכוללים שדות ותכונות שספציפיים לתרחיש לדוגמה, כמו כרטיסים לאירועים, כרטיסי מועדון לקוחות ומבצעים, הכרטיס הגנרי נועד להיות גמיש מספיק כדי לתמוך במגוון מטרות, על ידי מתן שדות שבהם אפשר להגדיר תוויות וערכים בהתאמה אישית.
תרחישים לדוגמה
הנה כמה דוגמאות למה שאפשר לעשות עם סוג הכרטיס הגנרי:
- כרטיסי חניה
- כרטיסי ספרייה
- כרטיסי מינוי
- כרטיסי ביטוח
- אישורי הזמנות
- קודי אישור לסינון מקדים של לקוחות
כרטיסים שמכילים מידע רגיש
יש מקרים שבהם הכרטיס או תרחיש השימוש שלכם עשויים לכלול מידע רגיש, כמו פרטים אישיים מזהים (PII) ונתוני בריאות וכושר. במקרים כאלה, אפשר להשתמש בסוג הכרטיס "כרטיס פרטי כללי" למטרות שאושרו מראש. מידע נוסף זמין במסמכי התיעוד של כרטיס פרטי כללי ובמדיניות השימוש המקובל (AUP).
פלטפורמות נתמכות
באמצעות Google Wallet API, אתם יכולים להנפיק כרטיסים שהמשתמשים יוכלו לשמור ב-Google Wallet שלהם בפלטפורמות שונות, כולל אפליקציות לנייד, ובכל מקום שבו יש תמיכה בהיפר-קישורים, כמו אתרים, אימיילים והודעות SMS.
ממשקי API וערכות SDK
Google Wallet API מציע API בארכיטקטורת REST ו-Android SDK כדי לעזור לכם להנפיק ולנהל את הכרטיסים שלכם במהירות ובקלות.
- Google Wallet REST API
כדי להנפיק כרטיסים בפלטפורמות כמו אתרים, אפליקציות ל-iOS או לנייד, אימייל ו-SMS באמצעות קישורים של 'הוספה ל-Google Wallet', מומלץ להשתמש ב-Google Wallet API בארכיטקטורת REST. ה-API מספק קבוצה של נקודות קצה (endpoints) שמאפשרות ליצור, לאחזר ולעדכן את הרכיבים השונים של הכרטיסים.
- Google Wallet Android SDK
כדי להנפיק כרטיסים באפליקציה ל-Android, מומלץ להשתמש ב-Google Wallet Android SDK. ה-SDK מספק מגוון שיטות נוחות שמאפשרות לשלב בקלות את Google Wallet API באפליקציות לנייד באמצעות קוד Native.
הערה: לא חובה להשתמש ב-Google Wallet API בארכיטקטורת REST או ב-Google Wallet Android SDK כדי להנפיק כרטיסים באמצעות Google Wallet API, אבל מומלץ מאוד לעשות זאת. מידע נוסף על הנפקת כרטיסים בלי להשתמש ב-API בארכיטקטורת REST או ב-Android SDK זמין במאמר יצירת אובייקטים של כרטיסים ומחלקות של כרטיסים ב-JWT.
דרישות
כדי להנפיק כרטיסים באמצעות Google Wallet API, קודם צריך לבצע את הפעולות הבאות:- יוצרים חשבון מנפיק ב-Google Wallet API.
- מפתחים שלא משתמשים ב-Android: יוצרים חשבון Google Cloud.
- מפתחים ל-Android: הגדרת Google Play Services.
איך מתחילים להשתמש ב-Google Wallet API
לפני שמתחילים לעבוד עם Google Wallet API, כדאי לעיין במאמרים השימושיים האלה כדי להכיר את התכונות הבסיסיות ואת המונחים.- מושגים ומונחים עיקריים: המאמר הזה יכיר לכם את כל המונחים והתכונות החשובים שתצטרכו כדי לעבוד עם Google Wallet API.
- סקירה כללית של מחלקות ואובייקטים של כרטיסים: הכרטיסים שאתם מנפיקים למשתמשים נוצרים על ידי שילוב של מחלקת כרטיסים עם אובייקטים של כרטיסים. במאמר הזה נסביר על שני המושגים האלה ואיך משתמשים בהם כדי ליצור כרטיסים.
- תהליך הפיתוח של כרטיסים ל-Google Wallet: המאמר הזה מספק סקירה כללית מקצה לקצה של כל השלבים שצריך לבצע כדי ליצור כרטיס באמצעות Google Wallet API, מההתחלה ועד הסוף.
כלים ומשאבים
- Codelabs
שיעורי Lab ב-Codelabs להדרכה עצמית מדריכים אתכם בשלבים הנדרשים להוספת כרטיס ל-Google Wallet. כדי להתחיל, בוחרים באפשרות Android אם ההטמעה תהיה במכשירי Android בלבד, או באפשרות "אינטרנט" אם ההטמעה תומכת ב-Android, באינטרנט, באימייל או ב-SMS.
- הכלי ליצירת כרטיסים
אתם יכולים ליצור את הכרטיס הראשון שלכם באופן חזותי באמצעות הכלי ליצירת כרטיסים, וליצור באופן אוטומטי את קובץ ה-JSON שנדרש כדי ליצור את הכרטיס באמצעות Google Wallet API.
- Google Wallet Github
בארגון Google Wallet ב-GitHub אפשר למצוא כלים שימושיים, ספריות וקוד לדוגמה במגוון שפות תכנות.