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