התכונה 'פעולות שיחה' הוצאה משימוש ב-13 ביוני 2023. כאן תוכלו לקרוא מידע נוסף על ההוצאה משימוש של 'פעולות שיחה'.

דף זה תורגם על ידי Cloud Translation API.

הפעלת קישור לחשבון Google ישירות מהפלטפורמה שלך.

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

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

היתרונות למשתמשים כוללים:

המשתמשים יכולים להתחיל ולהשלים את תהליך קישור החשבונות באפליקציה שלך, סביבה שהם כבר מכירים.
משתמשים לא דורשים פרטי כניסה, מכיוון שהם כבר אומתו במכשיר ובאפליקציה לנייד.

היתרונות למפתחים כוללים:

ניתן לקבוע היכן לקדם ולהפעיל קישור חשבונות באפליקציה לנייד, לדוגמה, בהגדרות המשתמש, במודעות מעברון או אחרי שמשתמש נכנס לאפליקציה לנייד. הוספת מספר נקודות כניסה להפעלת קישור חשבון עוזרת להפוך את הקישור של החשבון לגלוי יותר, וכתוצאה מכך יש יותר מעורבות ומספר החשבונות המקושרים.
עלייה בשיעור ההמרה, כי משתמשים יכולים להשלים את תהליך הקישור בפחות שלבים מתהליך ה-OAuth הרגיל לאינטרנט.
נדרש מאמץ נמוך של הנדסה כדי להטמיע קישור מהפלטפורמה שלך (Android), כי התהליך הזה ממנף את ההטמעה הקיימת של OAuth2.0 בהנחה שכבר ביצעת הטמעה כזו.
שיעורי נשירה מופחתים מפני שמשתמשים לא צריכים להזין מחדש את פרטי ההתחברות שלהם והם יכולים להשלים את התהליך בפחות שלבים. שיעורי הנשירה עשויים להיות גבוהים עד 80% בנתיבים שבהם המשתמשים נדרשים להיזכר ולהזין את פרטי הכניסה שלהם.

איך זה עובד

כדי לבצע את הקישור מהפלטפורמה, צריך לפעול לפי השלבים הבאים:

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

איור 1. קישור מזרימת הפלטפורמה

דרישות

כדי להטמיע קישור מהפלטפורמה, צריך:

אפליקציה ל-Android.
יש לכם שרת OAuth 2.0: אתם יכולים להשתמש בו, לנהל ולתחזק שרת OAuth 2.0 שתומך בזרימת קוד הרשאה של OAuth 2.0.

הגדרה

לפני שתתחילו את השלבים הבאים, עליכם להשלים את תהליך הרישום של קישור החשבון.

הגדרת סביבת הפיתוח

אפשר לקבל את הגרסה העדכנית ביותר של Google Play Services אצל מארח הפיתוח:

פותחים את מנהל ה-SDK של Android.

בקטע SDK Tools, מאתרים את Google Play Services.
אם הסטטוס של החבילות האלה הוא 'לא מותקנת', בוחרים את שתיהן ולוחצים על התקנת חבילות.

הגדרת האפליקציה

בקובץ build.gradle ברמת הפרויקט, כוללים את מאגר Maven של Google בקטע buildscript וגם בקטע allprojects.
```
buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}
```
מוסיפים את יחסי התלות של ה-API של Link with Google לקובץ gradle ברמת האפליקציה של המודול, שהוא בדרך כלל app/build.gradle:
```
dependencies {
  implementation 'com.google.android.gms:play-services-auth:21.3.0'
}
```

הוספת תמיכה בקישור מהפלטפורמה

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

כדי לקבל הסכמה מהמשתמש ולהחזיר אסימון של קוד אימות דרך Google Play Services SDK, צריך לפעול לפי השלבים הבאים.

פיתוח PendingIntent שיכול להפעיל את פעילות ההסכמה שלכם – ההסכמה מופעלת על ידי Play Services API. יהיה עליך לספק PendingIntent (לשם הבהרה, ייקרא consentPendingIntent) כשתתבצע קריאה ל-API
KotlinJava
```
// Build a PendingIntent that can launch the consent activity
val consentPendingIntent = buildConsentPendingIntent()
```
```
// Build a PendingIntent that can launch your consent activity
PendingIntent consentPendingIntent =
          buildConsentPendingIntent();
```

יוצרים פעילות תואמת כדי לטפל בכוונת ההסכמה

KotlinJava

  class ConsentActivity : AppCompatActivity

  private fun onConsentAccepted() {
      // Obtain a token (for simplicity, we’ll ignore the async nature
      // of the following call)
      val token = getToken()
      val intent = Intent()
                  .putExtra(SaveAccountLinkingTokenRequest.EXTRA_TOKEN,
                            token)
      setResult(Activity.RESULT_OK, intent)
      finish()
  }

  private fun onConsentRejectedOrCanceled() {
      setResult(Activity.RESULT_CANCELED)
      finish()
  }

  public class ConsentActivity extends AppCompatActivity {
    ...
    private void onConsentAccepted() {
      // Obtain a token (for simplicity, we’ll ignore the async nature of
      // the following call
      String token = getToken();
      Intent intent = new Intent();
      intent.putExtra(SaveAccountLinkingTokenRequest.EXTRA_TOKEN, token);
      setResult(Activity.RESULT_OK, intent);
      finish();
    }

    private void onConsentRejectedOrCanceled() {
      setResult(Activity.RESULT_CANCELED, null);
      finish();
    }
 }

אנחנו מניחים שהשיטות onConsentAccpeted() ו-onConsentRejectedOrCanceled() יופעלו אם המשתמש מאשר או דוחה או מבטל את ההסכמה שלכם, בהתאמה.

יוצרים בקשה לשמירת האסימון, ובין פרמטרים אחרים של הגדרה מעבירים את PendingIntent שנוצר בשלב 1 שלמעלה.

KotlinJava

  // Create an ActivityResultLauncher which registers a callback for the
  // Activity result contract
  val activityResultLauncher = registerForActivityResult(
    ActivityResultContracts.StartIntentSenderForResult())
    { result ->
      if (result.resultCode == RESULT_OK) {
        // Successfully finished the flow and saved the token
      } else {
        // Flow failed, for example the user may have canceled the flow
      }
    }

  // Build token save request
  val request = SaveAccountLinkingTokenRequest.builder()
    .setTokenType(SaveAccountLinkingTokenRequest.TOKEN_TYPE_AUTH_CODE)
    .setConsentPendingIntent(consentPendingIntent)
    .setServiceId("service-id-of-and-defined-by-developer")
    //Set the scopes that the token is valid for on your platform
    .setScopes(scopes)
    .build()

   // Launch consent activity and retrieve token
   Identity.getCredentialSavingClient(this)
     .saveAccountLinkingToken(request)
     .addOnSuccessListener( saveAccountLinkingTokenResult -> {
        if (saveAccountLinkingTokenResult.hasResolution()) {
          val pendingIntent = saveAccountLinkingTokenResult
                              .getPendingIntent()
          val intentSenderRequest = IntentSenderRequest
                                    .Builder(pendingIntent).build()
          activityResultLauncher.launch(intentSenderRequest)
        } else {
           // This should not happen, let’s log this
           Log.e(TAG, "Failed to save token");
        }
      })
      .addOnFailureListener(e -> Log.e(TAG, “Failed to save token”, e))

  // Create an ActivityResultLauncher which registers a callback for the
  // Activity result contract
  ActivityResultLauncher<IntentSenderRequest>
      activityResultLauncher =
      registerForActivityResult(new ActivityResultContracts
                                    .StartIntentSenderForResult(),
                                result -> {
      if (result.getResultCode() == RESULT_OK) {
          // Successfully finished the flow and saved the token
      } else {
          // Flow failed, for example the user may have canceled the flow
      }
  });

 // Build token save request
 SaveAccountLinkingTokenRequest request =
    SaveAccountLinkingTokenRequest.builder()
        .setTokenType(
            SaveAccountLinkingTokenRequest.TOKEN_TYPE_AUTH_CODE)
        .setConsentPendingIntent(consentPendingIntent)
        .setServiceId("service-id-of-and-defined-by-developer")
        //Set the scopes that the token is valid for on your platform
        .setScopes(scopes)
        .build();

  // Launch consent activity and retrieve token
  Identity.getCredentialSavingClient(this)
      .saveAccountLinkingToken(request)
      .addOnSuccessListener(
          saveAccountLinkingTokenResult -> {
            if (saveAccountLinkingTokenResult.hasResolution()) {
              // Launch the resolution intent
              PendingIntent pendingIntent =
                  saveAccountLinkingTokenResult.getPendingIntent();
              IntentSenderRequest intentSenderRequest =
                  new IntentSenderRequest.Builder(pendingIntent).build();
              activityResultLauncher.launch(intentSenderRequest);
            } else {
              // This should not happen, let’s log this
              Log.e(TAG, "Failed to save token");
            }
          })
      .addOnFailureListener(e -> Log.e(TAG, "Failed to save token", e));
  ```

השלבים שלמעלה מבקשים מהמשתמשים הסכמה ומחזירים ל-Google קוד הרשאה.

שיטות מומלצות

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

איור 1. תמונה לדוגמה של סטטוס קישור
אחרי שהקישור יפעל, כדאי להודיע למשתמש. לדוגמה, אפשר להציג הודעה קופצת, להפעיל שינוי מצב של מתג או להפנות את המשתמש לדף נפרד של אישור קישור.
מומלץ לבקש ממשתמשים באפליקציה לקשר חשבונות. רצוי על סמך אותות חזקים לכך שקישור יועיל למשתמשים כאלה.
לאחר הקישור, צריך לתת למשתמשים דוגמה למה לעשות עם החשבון המקושר, למשל. אם קישרת לאחרונה שירות סטרימינג של מוזיקה, אפשר לבקש מ-Google Assistant להשמיע מוזיקה.
המשתמשים יכולים לנהל את החשבונות המקושרים שלהם, כולל אפשרות לבטל את הקישור של החשבונות. להפנות אותו לדף הניהול של חשבונות Google המקושרים אליו, כלומר https://myaccount.google.com/accountlinking.

חומרי עזר

מסמכי עזר של Android auth API