אחרי שמטמיעים את OAuth 2.0, אפשר להגדיר App Flip שמבוסס על OAuth. כך המשתמשים ב-Android יוכלו לקשר את החשבונות שלהם במערכת האימות לחשבונות Google שלהם מהר יותר. בקטעים הבאים מוסבר איך לתכנן ולהטמיע את App Flip בשילוב של Cloud-to-cloud.
Design guidelines
This section describes the design requirements and recommendations for the App Flip account linking consent screen. After Google calls your app, your app displays the consent screen to the user.
Requirements
- You must have a Google authorization statement such as "Once linked, Google will have permission to control your devices."
- You must communicate that the user's account is being linked to Google, not to a specific Google product, such as Google Home or Google Assistant.
- You must state a clear call-to-action on your consent screen and use the wording "Agree and link" for linking action. This is because users need to understand what data they're required to share with Google to link their accounts.
- You must provide a way for users to go back or cancel, if they choose not to link. Use the wording "Cancel" for the cancel action.
- You must implement this workflow: After clicking "Agree and link", you must show linking success and redirect the user back to the Google Home app automatically. The user should now see the linked device on the Google Home app with your action. After clicking "Cancel" you should redirect the user back to the Google Home app.
Recommendations
We recommend that you do the following:
Display Google's Privacy Policy. Include a link to Google's Privacy Policy on the consent screen.
Data to be shared. Use clear and concise language to tell the user what data of theirs Google requires and why.
Ability to unlink. Offer a mechanism for users to unlink, such as a URL to their account settings on your platform. Alternatively, you can include a link to Google Account where users can manage their linked account.
Ability to change user account. Suggest a method for users to switch their account(s). This is especially beneficial if users tend to have multiple accounts.
- If a user must close the consent screen to switch accounts, send a recoverable error to Google so the user can sign in to the desired account with OAuth linking and the implicit flow.
Include your logo. Display your company logo on the consent screen. Use your style guidelines to place your logo. If you wish to also display Google's logo, see Logos and trademarks.
הגדרה ל-App Flip מבוסס-OAuth
בקטעים הבאים מתוארים התנאים המוקדמים לשימוש ב-App Flip שמבוסס על OAuth, והסבר על הגדרת פרויקט App Flip במסוף הפיתוח של Google Home.
יצירת שילוב בין עננים והגדרת שרת OAuth 2.0
לפני שמגדירים את App Flip, צריך לבצע את הפעולות הבאות:
- הגדרת שרת OAuth 2.0 למידע נוסף על הגדרת שרת OAuth, ראו הטמעת שרת OAuth 2.0.
- יצירת שילוב בין עננים כדי ליצור שילוב, פועלים לפי ההוראות במאמר יצירת שילוב בין עננים.
הגדרת App Flip במסוף הפיתוח
בקטע הבא מוסבר איך להגדיר את App Flip ב-מסוף הפיתוח.
- ממלאים את כל השדות בקטע פרטי לקוח OAuth. (אם אין תמיכה ב-App Flip, המערכת תשתמש ב-OAuth רגיל כחלופה).
- בקטע שימוש באפליקציה לקישור החשבון(אופציונלי), מסמנים את התיבה הפעלה ל-iOS.
- ממלאים את השדה קישור אוניברסלי. מידע נוסף על קישורים אוניברסליים זמין במאמר מתן הרשאה לאפליקציות ולאתרים לקשר לתוכן שלכם.
- אם רוצים להגדיר את הלקוח, מוסיפים היקפי גישה ולוחצים על הוספת היקף גישה בקטע הגדרת הלקוח (אופציונלי).
- לוחצים על שמירה.
עכשיו אפשר להמשיך לקטע הבא כדי להטמיע את App Flip באפליקציה ל-iOS או ל-Android.
הטמעת App Flip באפליקציות המקומיות
כדי להטמיע את App Flip, צריך לשנות את קוד ההרשאה של המשתמש באפליקציה כדי לקבל קישור עומק מ-Google.
בדיקת App Flip במכשיר
אחרי שיצרתם שילוב בין עננים והגדרתם את App Flip במסוף ובאפליקציה, תוכלו לבדוק את App Flip במכשיר הנייד. אתם יכולים להשתמש באפליקציית Google Home כדי לבדוק את התכונה 'החלפת אפליקציות'.
כדי לבדוק את App Flip מאפליקציית Google Home:
- נכנסים ל-Developer Console ובוחרים את הפרויקט.
- עוברים אל Cloud-to-cloud > Test.
- מפעילים את תהליך קישור החשבון מאפליקציית Home:
- פותחים את Google Home app (GHA).
- לוחצים על הלחצן +.
- לוחצים על הגדרת המכשיר.
- לוחצים על כבר הגדרתם משהו?
- בוחרים את השילוב של Cloud-to-cloud מרשימת הספקים. ברשימה יופיע התו '[test]' לפני השם. כשבוחרים את השילוב [test] מהרשימה, האפליקציה אמורה להיפתח.
- מוודאים שהאפליקציה הושקתה ומתחילים לבדוק את תהליך ההרשאה.