סקירה כללית

OAuth-based App Flip Linking (App Flip) allows your users to easily and quickly link their accounts in your authentication system to their Google accounts. If your app is installed on your user’s phone when they initiate the account linking process, they are seamlessly flipped to your app to obtain user authorization.

This approach provides a faster and easier linking process since the user does not have to re-enter their username and password to authenticate; instead, App Flip leverages the credentials from the user's account on your app. Once a user has linked their Google account with your app, they can take advantage of any integrations that you have developed.

You can set up App Flip for both iOS and Android apps.

This figure shows the steps for a user to link their Google account to your authentication system. The first screenshot shows how a user can select your app if their Google account is linked to your app. The second screenshot shows the confirmation for linking their Google account with your app. The third screenshot shows a successfully linked user account in the Google app.
Figure 1. Account linking on a user's phone with App Flip.

Requirements

To implement App Flip, you must fulfill the following requirements:

  • You must have an Android or iOS app.
  • You must own, manage and maintain an OAuth 2.0 server which supports the OAuth 2.0 authorization code flow.

במאמר הטמעה של שרת OAuth תוכלו לקרוא מידע נוסף על תהליך הטמעת הקוד של הרשאת הקישור של OAuth.

הנחיות עיצוב

בקטע הזה מתוארות דרישות העיצוב וההמלצות לגבי מסך ההסכמה ליצירת קישור בין חשבונות. אחרי ש-Google מתקשרת לאפליקציה, האפליקציה מציגה למשתמש את מסך ההסכמה.

דרישות

  1. עליך להודיע שהחשבון של המשתמש מקושר ל-Google, לא למוצר ספציפי של Google, כגון Google Home או Google Assistant.

המלצות

מומלץ לבצע את הפעולות הבאות:

  1. הצגת מדיניות הפרטיות של Google. במסך הקישור יש לציין את מדיניות הפרטיות של Google.

  2. הנתונים לשיתוף. השתמש בשפה ברורה ותמציתית כדי לספר למשתמש אילו נתונים הוא דורש ומדוע.

  3. קריאה ברורה לפעולה. יש לציין במסך קריאה ברורה פעולה, כמו "הסכמה וקישור", כי המשתמשים צריכים להבין אילו נתונים הם נדרשים לשתף עם Google כדי לקשר את החשבונות שלהם.

  4. יכולת לבטל. למשתמשים תהיה אפשרות לחזור אחורה או לבטל את המינוי אם הם יבחרו שלא לקשר.

  5. יכולת לבטל את הקישור. צריך להציע למשתמשים מנגנון לביטול הקישור, כמו כתובת URL להגדרות החשבון בפלטפורמה שלהם. לחלופין, אפשר לכלול קישור לחשבון Google, שבו המשתמשים יכולים לנהל את החשבון המקושר שלהם.

  6. היכולת לשנות את חשבון המשתמש. להציע למשתמשים שיטה להחלפת החשבונות שלהם. אפשרות זו שימושית במיוחד אם למשתמשים יש מספר חשבונות.

    • אם משתמש צריך לסגור את מסך ההסכמה כדי להחליף חשבון, צריך לשלוח ל-Google הודעת שגיאה ניתנת לשחזור. כך הוא יוכל להיכנס לחשבון הרצוי באמצעות קישור OAuth ותהליך המשתמע.

  7. הלוגו צריך לכלול. הצגת הלוגו של החברה במסך ההסכמה. היעזרו בהנחיות הסגנון כדי למקם את הלוגו. אם ברצונך להציג גם את הלוגו של Google, יש לעיין בלוגו ובסימנים מסחריים.

בתרשים הזה מוצג מסך הסכמה לדוגמה עם קריאה לפעולה לדרישות האישיות ולהמלצות שצריך ליישם כשמעצבים מסך הסכמה למשתמש.
איור 2. הנחיות לעיצוב מסך הסכמה בחשבון.

הגדרה ל-App Flip מבוסס OAuth

בקטעים הבאים מתוארים הדרישות המוקדמות לשימוש ב-App Flip על בסיס OAuth, ואיך להגדיר את פרויקט App Flip במסוף הפעולות.

יצירת פעולה והגדרת שרת OAuth 2.0

לפני שתוכל להגדיר App Flip, עליך לבצע את הפעולות הבאות:

הגדרה של 'היפוך אפליקציות' במסוף Actions

בקטע הבא מוסבר איך להגדיר 'היפוך אפליקציה' בקונסולה ל-Actions.

  1. בתפריט הניווט העליון, לוחצים על פיתוח. לאחר מכן לוחצים על קישור חשבונות בתפריט הניווט הימני.
  2. מעבירים את המתג שלצד קישור חשבונות למצב מופעל.
  3. בקטע יצירת חשבון, בוחרים באפשרות לא, אני רוצה לאפשר רק ליצור חשבון באתר שלי.
  4. לוחצים על הבא.
  5. בקטע Linking type (סוג הקישור), בוחרים באפשרות OAuth וב-Authorization code בתפריטים הנפתחים.
  6. לוחצים על הבא.
  7. מלא את כל השדות בקטע פרטי לקוח OAuth. (אם אין תמיכה ב-App Flip, ה-OAuth הרגיל משמש כחלופה).
  8. לוחצים על הבא.
  9. בקטע שימוש באפליקציה שלך לקישור חשבונות (אופציונלי), מסמנים את האפשרות הפעלה ל-iOS.
  10. מלא את השדה קישור אוניברסלי. למידע נוסף על קישורים אוניברסליים, אפשר לעיין במאמר מתן הרשאה לאפליקציות ולאתרים לקשר לתוכן שלך .
  11. אם ברצונך להגדיר את הלקוח באופן אופציונלי, מוסיפים היקפים ולוחצים על הוספת היקף בקטע הגדרת הלקוח (אופציונלי). אם לא, לוחצים על הבא.
  12. בקטע 'הוראות לבדיקה', מקלידים test (או כל מחרוזת אחרת) כ-placeholder. (חובה למלא בשדה הזה חשבון בדיקה רק אם בחרת לשלוח בפועל את הפעולה לפרסום).
  13. לוחצים על שמירה.

עכשיו אפשר להמשיך לקטע הבא כדי להטמיע App Flip באפליקציה ל-iOS או ל-Android.

הטמעת 'היפוך אפליקציה' באפליקציות המקוריות

כדי להטמיע את App Flip, עליך לשנות את קוד ההרשאה של המשתמש באפליקציה כך שיקבל קישור עומק מ-Google.

בדיקת Flip של אפליקציה במכשיר

אחרי שיצרתם פעולה והגדרתם היפוך אפליקציה במסוף ובאפליקציה, תוכלו לבדוק את App Flip בנייד שלכם. תוכלו להשתמש באפליקציית Google Assistant כדי לבדוק את App Flip.

כדי לבדוק את התכונה 'היפוך אפליקציה' דרך אפליקציית Assistant:

  1. נכנסים אל Actions Console ובוחרים את הפרויקט.
  2. לוחצים על בדיקה בתפריט הניווט העליון.
  3. מפעילים את תהליך קישור החשבון מאפליקציית Assistant:
    1. פותחים את אפליקציית Google Assistant.
    2. לוחצים על הגדרות.
    3. בכרטיסייה Assistant, לוחצים על Home Control.
    4. לוחצים על Add(+).
    5. בוחרים את הפעולה הרצויה מרשימת הספקים. הרשימה תופיע עם התחילית '[test]'. כשבוחרים את פעולת [הבדיקה] מהרשימה, האפליקציה אמורה להיפתח.
    6. צריך לוודא שהאפליקציה הופעלה ולהתחיל לבדוק את תהליך ההרשאה.