ב-Google Wallet יש ממשק API ל-REST שמאפשר ליצור ולנהל כרטיסים על ידי שליחת בקשות ל-Google Wallet API באמצעות HTTP. זו אפשרות שימושית למי שרוצה ליצור באופן פרוגרמטי שירותים בצד השרת כדי שיעבדו עם כרטיסים באופן פרוגרמטי.
כדי להשתמש ב-Google Wallet REST API, צריך להפעיל את ה-API במסוף Google Cloud, ליצור חשבון שירות ב-Google Cloud ואז ליצור מפתח לחשבון השירות.
כשיוצרים כרטיסים באמצעות API ל-REST, המפתח של חשבון השירות שמשמש לחתימה על אובייקטים מסוג Passes שמקודדים ב-JSON Web Token.
בפעולות אחרות, כמו עדכון או מחיקה של כרטיסים, המפתח של חשבון השירות נשלח עם הבקשה לאימות הזהות שלכם כמנפיקי הכרטיסים.
1. הפעלת ה-API ל-REST של Google Wallet
כדי להפעיל את Google Wallet REST API, יש לבצע את הפעולות הבאות:
- אם אין לכם עדיין חשבון ב-Google Cloud, תוכלו להיכנס למסוף Google Cloud ולפעול לפי השלבים כדי להירשם לחשבון חדש.
- בוחרים את הפרויקט ב-Google Cloud שבו רוצים להשתמש או יוצרים פרויקט חדש בתפריט הנפתח שבחלק העליון של המסוף.
- עבור אל דף פרטי המוצר של Google Wallet API ב-Marketplace של מסוף Google Cloud.
- לוחצים על הלחצן 'הפעלה'. בעוד כמה דקות, ה-API ל-REST של Google Wallet יהיה זמין לפרויקט הנבחר ב-Google Cloud.
2. יצירת מפתח לחשבון שירות ב-Google Cloud
כדי לאמת בקשות ל-API ל-REST של Google Wallet, עליכם ליצור חשבון שירות וליצור מפתח לחשבון שירות. לשם כך:
- נכנסים לדף Create service account במסוף Google Cloud.
- ממלאים את פרטי חשבון השירות. שימו לב לכתובת האימייל של חשבון השירות שמופיעה מתחת לשדה Service account ID. תצטרכו אותה מאוחר יותר כשמשתמשים בחשבון השירות כדי לאמת את הבקשות שלכם ל-API ל-REST של Google Wallet.
- לוחצים על הלחצן 'סיום'. אין צורך להשלים את השלבים האחרים ליצירת חשבון שירות.
- לוחצים על האפשרות 'מפתחות' בחלק העליון של הדף.
- לוחצים על התפריט הנפתח 'הוספת מפתח' ואז לוחצים על 'יצירת מפתח חדש'.
- בוחרים את סוג המפתח 'JSON'.
- כדי ליצור ולהוריד את המפתח לחשבון השירות, צריך ללחוץ על 'CREATE'.
3. אשר את חשבון השירות שלך במסוף Google Wallet
כדי לאמת את הבקשות שלך ל-API ל-REST של Google Wallet באמצעות מפתח לחשבון שירות, עליך להוסיף את כתובת האימייל של חשבון השירות שלך כמשתמש לחשבון המנפיק. כדי להוסיף את חשבון השירות כמשתמש:
- עוברים לדף Service accounts במסוף Google Cloud.
- העתק את כתובת האימייל של חשבון השירות שבו אתה רוצה להשתמש כדי לאמת את הבקשות שלך לממשק ה-API של Google Wallet.
- נכנסים למסוף Google Pay ו-Wallet.
- בתפריט הניווט הימני, לוחצים על 'משתמשים'.
- לוחצים על 'הזמנת משתמש'.
- מזינים את כתובת האימייל של חשבון השירות.
- בתפריט הנפתח 'רמת גישה', בוחרים באפשרות 'מפתח'.
- לחץ על הלחצן 'הזמנה'.
אחרי שמוסיפים את חשבון השירות, אפשר להשתמש בכל מפתחות של חשבונות השירות שנוצרו עבורו כדי לאמת בקשות ל-API ל-REST של Google Wallet. כשמשתמשים במפתחות של חשבונות שירות, חשוב לזכור שאלו פרטי כניסה רגישים מאוד שצריך להשתמש בהם רק בסביבות מאובטחות בצד השרת.