קישורי עומק

Google Home app (GHA) היא הדרך העיקרית שבה המשתמשים מחברים מכשירים חכמים ל-Google Assistant ומקצים אותם למבנים ולחדרים ב-Google Home Graph. כדי לבצע את ההגדרה, המשתמשים בדרך כלל לוחצים על כמה מסכים כדי למצוא את השילוב של Cloud-to-cloud מתוך רשימה של אפשרויות זמינות. ככל שתהליך ההגדרה יהיה קל יותר, כך המשתמשים יוכלו להתחיל להשתמש באפליקציה מהר יותר, וזה יפחית את התסכול שלהם.

קישורי עומק מאפשרים להטמיע קישור עומק באפליקציה או באתר המוצר, כדי שהמשתמשים יוכלו לחבר בקלות את מכשיר smart home שלהם אל Assistant. לחיצה על הקישור תבקש מהמשתמשים להוריד את GHA (אם היא עדיין לא מותקנת), ותפעיל את תהליך ההגדרה של קישור החשבון והקצאת החדרים.

קישור עומק ל-Google Home

קישורי עומק מאפשרים להעביר את המשתמשים ישירות ליעד ספציפי בGHA מהאפליקציה ל-Android או ל-iOS, וכך לפשט את תהליך הגדרת המכשיר.

כדי להתחיל את תהליך קישור החשבון ישירות ב-GHA, צריך להשתמש בקישור האוניברסלי הבא:

https://home.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

‫agent-id הוא מזהה הפרויקט של השילוב בין הענן לענן, שמופיע בGoogle Home Developer Console בהגדרות הפרויקט.

באפליקציות לנייד שמופעלות באמצעות סכימה בהתאמה אישית (Android ו-iOS), אפשר גם להשתמש ב:

googlehome://setup/ha_linking?agent_id=agent-id

כשמשתמשים לוחצים על הקישור האוניברסלי, הפלטפורמה לנייד בודקת אם GHA קיימת ופותחת את תהליך קישור החשבון. אם האפליקציה GHA לא מותקנת במכשיר של המשתמש, צריך לספק טיפול חלופי כדי לנתב את המשתמש להתקנה או לעדכון של האפליקציה מ-Google Play או מ-App Store של אפל.

Intent מפורש ב-Android

כדי להפעיל את תהליך קישור החשבון ישירות מהאפליקציה ל-Android באמצעות Intent מפורש:

val intent = Intent(Intent.ACTION_VIEW).apply {
    val agentId = "YOUR_AGENT_ID"
    data = Uri.parse("googlehome://setup/ha_linking?agent_id=$agentId")
    setPackage("com.google.android.apps.chromecast.app")
}
try {
    startActivity(intent)
} catch (e: ActivityNotFoundException) {
    // Fallback: open Google Play app, with web browser safety
    try {
        val playStoreIntent = Intent(Intent.ACTION_VIEW,
            Uri.parse("market://details?id=com.google.android.apps.chromecast.app"))
        startActivity(playStoreIntent)
    } catch (e: ActivityNotFoundException) {
        val playStoreUrl =
            "https://play.google.com/store/apps/details?id=com.google.android.apps.chromecast.app"
        val webIntent = Intent(Intent.ACTION_VIEW, Uri.parse(playStoreUrl))
        startActivity(webIntent)
    }
}

כתובות URL מדור קודם של קישורי עומק בפורמט madeby.google.com או assistant.google.com הוצאו משימוש:

https://madeby.google.com/home-app/?deeplink=setup%2Fha_linking%3Fagent_id%3Dagent-id

מעדכנים את כל הכפתורים באפליקציה ואת אתרי המוצרים כך שישתמשו בקישור האוניברסלי או ב-Scheme המותאם אישית googlehome://setup/ha_linking.

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