אחרי שמטמיעים את 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) במסוף הפעולות.
יצירת פעולה בבית חכם והגדרת שרת OAuth 2.0
כדי להגדיר את App Flip, צריך לבצע את הפעולות הבאות:
- הגדרה של שרת OAuth 2.0 למידע נוסף על הגדרת OAuth לשרת, תוכלו לקרוא את המאמר הטמעה של שרת OAuth 2.0.
- יוצרים פעולה. כדי ליצור פעולה, פועלים לפי ההוראות ב יוצרים פרויקט Actions.
הגדרת App Flip במסוף הפעולות
בקטע הבא מוסבר איך להגדיר את App Flip ב Actions Console.
- ממלאים את כל השדות בקטע פרטי לקוח 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, לוחצים על בקרה על הבית.
- לוחצים על Add(+).
- בוחרים את הפעולה מרשימת הספקים. זה יהיה עם הקידומת '[test]' ברשימה. כשבוחרים את פעולת [בדיקה] מתוך הרשימה אמורה לפתוח את האפליקציה שלך.
- מוודאים שהאפליקציה הופעלה ומתחילים לבדוק את תהליך ההרשאה.
כדי לבדוק את App Flip מהאפליקציה Google Home, יש לבצע את הפעולות הבאות:
- עוברים אל Actions Console ובוחרים את הפרויקט.
- בתפריט הניווט העליון לוחצים על בדיקה.
- מפעילים את תהליך קישור החשבון מאפליקציית Home:
- פותחים את Google Home app (GHA).
- לוחצים על הלחצן +.
- לוחצים על הגדרת המכשיר.
- לוחצים על כבר יש לך משהו מוגדר?
- בוחרים את פעולת smart home מרשימת הספקים. זה יהיה עם הקידומת '[test]' ברשימה. כשבוחרים את פעולת [בדיקה] מתוך הרשימה אמורה לפתוח את האפליקציה שלך.
- מוודאים שהאפליקציה הופעלה ומתחילים לבדוק את תהליך ההרשאה.