Deep linking

The Google Home app (GHA) adalah cara utama pengguna menghubungkan perangkat smart ke Google Assistant dan menetapkannya ke struktur dan ruangan di Google Home Graph. Untuk melakukan penyiapan, pengguna biasanya mengklik beberapa layar untuk menemukan integrasi Cloud-to-cloud Anda dari daftar opsi yang tersedia. Dengan mempermudah pengguna memulai proses penyiapan, Anda dapat membantu mereka melakukan orientasi dengan lebih cepat dan mengurangi frustrasi pengguna saat melakukan penyiapan.

Deep Linking memungkinkan Anda menyematkan deep link di aplikasi atau situs produk agar pengguna dapat dengan mudah menghubungkan perangkat smart home mereka ke Assistant. Mengklik link akan meminta pengguna mendownload the GHA (jika belum diinstal), dan meluncurkan alur penyiapan penautan akun dan penetapan ruangan.

Deep link ke Google Home

Deep link memungkinkan Anda mengarahkan pengguna langsung ke tujuan tertentu dalam GHA dari aplikasi Android atau iOS, sehingga menyederhanakan proses penyiapan perangkat.

Untuk memulai penautan akun langsung di GHA, gunakan Universal Link berikut:

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

Dengan agent-id adalah Project ID integrasi Cloud-to-cloud Anda, yang dapat Anda temukan di Google Home Developer Console di bagian setelan project.

Untuk aplikasi seluler yang diluncurkan menggunakan skema kustom (Android dan iOS), Anda juga dapat menggunakan:

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

Saat pengguna mengklik Universal Link, platform seluler akan memeriksa keberadaan dari GHA dan membuka alur penautan akun. Jika GHA tidak diinstal di perangkat pengguna, berikan penanganan penggantian untuk mengarahkan pengguna menginstal atau mengupdate aplikasi dari Google Play atau Apple App Store.

Intent eksplisit Android

Untuk memicu alur penautan akun langsung dari aplikasi Android Anda menggunakan intent eksplisit:

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 deep link lama yang diformat dengan madeby.google.com atau assistant.google.com tidak digunakan lagi:

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

Update semua tombol dalam aplikasi dan situs produk untuk menggunakan Universal Link atau skema kustom googlehome://setup/ha_linking.

Untuk mengetahui detail selengkapnya tentang cara memicu deep link dari dalam aplikasi, lihat dokumentasi Android dan dokumentasi iOS yang relevan.