אחרי הטמעת OAuth 2.0, תוכלו לבחור להגדיר App Flip מבוסס-אימות, שיאפשר למשתמשים לקשר מהר יותר את החשבונות שלהם במערכת האימות לחשבונות Google שלהם. בקטעים הבאים מוסבר איך לעצב את App Flip ולהטמיע אותו עבור הפעולה smart home.
הנחיות עיצוב
בקטע הזה מתוארות דרישות העיצוב וההמלצות בקשר למסך ההסכמה לקישור חשבון Applip. אחרי ש-Google מתקשרת לאפליקציה, מסך ההסכמה מוצג למשתמש.
דרישות
- צריכה להיות לך הצהרת הרשאה של Google, כמו 'לאחר הקישור, ל-Google תהיה הרשאה לשלוט במכשירים שלך'.
- עליך לציין שחשבון המשתמש מקושר ל-Google, ולא למוצר ספציפי של Google, כמו Google Home או Google Assistant.
- חובה לציין קריאה ברורה לפעולה במסך ההסכמה ולהשתמש בניסוח 'הסכמה וקישור' עבור פעולת הקישור. הסיבה לכך היא שהמשתמשים צריכים להבין אילו נתונים הם צריכים לשתף עם Google כדי לקשר את החשבונות שלהם.
- עליך לספק למשתמשים אפשרות לחזור אחורה או לבטל את הקישור, אם הם בוחרים שלא לקשר את החשבון. כשמדובר בפעולת ביטול, צריך להשתמש בניסוח 'ביטול'.
- חובה להטמיע את תהליך העבודה הזה: אחרי שלוחצים על 'אישור וקישור', צריך לוודא שהקישור בוצע בהצלחה ולהפנות את המשתמש חזרה לאפליקציית Google Home באופן אוטומטי. עכשיו המשתמש אמור לראות את המכשיר המקושר באפליקציית Google Home יחד עם הפעולה שביצעת. אחרי הלחיצה על 'ביטול', צריך להפנות את המשתמש בחזרה לאפליקציית Google Home.
המלצות
מומלץ לבצע את הפעולות הבאות:
הצגת מדיניות הפרטיות של Google. מוסיפים במסך ההסכמה קישור למדיניות הפרטיות של Google.
נתונים לשיתוף. משתמשים בשפה ברורה ותמציתית כדי להסביר למשתמשים אילו נתונים Google דורשת מהם ולמה.
יכולת לבטל את הקישור. להציע למשתמשים מנגנון לביטול הקישור, כמו כתובת URL להגדרות החשבון שלהם בפלטפורמה. לחלופין, אפשר לכלול קישור לחשבון Google שבו המשתמשים יוכלו לנהל את החשבון המקושר שלהם.
יכולת לשנות חשבון משתמש. להציע למשתמשים שיטה למעבר בין חשבונות. האפשרות הזו שימושית במיוחד אם למשתמשים יש בדרך כלל כמה חשבונות.
- אם משתמש צריך לסגור את מסך ההסכמה כדי לעבור בין חשבונות, צריך לשלוח ל-Google הודעת שגיאה שניתנת לשחזור, כדי שהמשתמש יוכל להיכנס לחשבון הרצוי באמצעות האפשרות OAuth Linking והתהליך משתמע.
מוסיפים את הלוגו שלכם. מציגים את לוגו החברה במסך ההסכמה. אפשר להיעזר בהנחיות הסגנון כדי להציב את הלוגו. אם אתם רוצים להציג גם את הלוגו של Google, קראו את המאמר סמלי לוגו וסימנים מסחריים.
הגדרת הכרטיס App Flip מבוסס OAuth
בקטעים הבאים מתוארות הדרישות המוקדמות לשימוש ב-App Flip מבוסס OAuth, ואיך מגדירים את פרויקט App Flip במסוף Actions.
יצירת פעולה בבית חכם והגדרת שרת OAuth 2.0
כדי להגדיר את App Flip, צריך:
- מגדירים שרת OAuth 2.0. למידע נוסף על ההגדרה של שרת OAuth, תוכלו לקרוא את המאמר הטמעה של שרת OAuth 2.0.
- יצירת פעולה. כדי ליצור פעולה, פועלים לפי ההוראות במאמר יצירת פרויקט פעולות.
צריך להגדיר את App Flip במסוף הפעולות
בקטע הבא מוסבר איך מגדירים את App Flip במסוף Actions.
- ממלאים את כל השדות בקטע פרטי לקוח OAuth. (אם אין תמיכה ב-App Flip, OAuth רגיל ישמש כחלופה).
- בקטע שימוש באפליקציה לקישור חשבונות(אופציונלי), מסמנים את האפשרות הפעלה ל-iOS.
- יש למלא את השדה קישור אוניברסלי. מידע נוסף על קישורים אוניברסליים זמין במאמר איך מאפשרים לאפליקציות ולאתרים לקשר לתוכן שלכם.
- אם רוצים להגדיר את הלקוח (אופציונלי), מוסיפים היקפים ולוחצים על הוספת היקף בקטע הגדרת הלקוח (אופציונלי).
- לוחצים על שמירה.
עכשיו אפשר להמשיך לקטע הבא כדי להטמיע את App Flip באפליקציה ל-iOS או Android.
יישום App Flip באפליקציות המקוריות שלך
כדי להטמיע את App Flip, צריך לשנות את קוד ההרשאה של המשתמש באפליקציה ולקבל קישור עומק מ-Google.
בדיקה של App Flip במכשיר
אחרי שיצרתם פעולה והגדרתם את App Flip במסוף ובאפליקציה, אתם יכולים לבדוק את App Flip בנייד שלכם. אפשר להשתמש ב-Google Assistant app או ב-Google Home app (GHA) כדי לבדוק את App Flip.
כדי לבדוק את App Flip ב-Google Assistant app, יש לבצע את השלבים הבאים:
- נכנסים אל Actions Console ובוחרים את הפרויקט.
- בתפריט הניווט העליון, לוחצים על בדיקה.
- מפעילים את תהליך הקישור של החשבון מאפליקציית Google Assistant:
- פותחים את Google Assistant app.
- לוחצים על הגדרות.
- בכרטיסייה Assistant, לוחצים על Home Control (בית חכם).
- לוחצים על Add(+) (הוספה).
- בוחרים את הפעולה מרשימת הספקים. התחילית של הבדיקה היא '[test]' ברשימה. כשבוחרים את הפעולה [test] מהרשימה, האפליקציה אמורה לפתוח את האפליקציה.
- יש לוודא שהאפליקציה הופעלה ולהתחיל לבדוק את תהליך ההרשאה.
כדי לבדוק את App Flip באפליקציה Google Home:
- נכנסים אל Actions Console ובוחרים את הפרויקט.
- בתפריט הניווט העליון, לוחצים על בדיקה.
- מפעילים את תהליך הקישור של החשבון מאפליקציית Home:
- פותחים את Google Home app (GHA).
- לוחצים על הלחצן +.
- לוחצים על הגדרת מכשיר.
- לוחצים על כבר יש לך משהו מוגדר?
- בוחרים את הפעולה smart home מרשימת הספקים. התחילית של הבדיקה היא '[test]' ברשימה. כשבוחרים את הפעולה [test] מהרשימה, האפליקציה אמורה לפתוח את האפליקציה.
- יש לוודא שהאפליקציה הופעלה ולהתחיל לבדוק את תהליך ההרשאה.