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