Deep linking

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 memudahkan pengguna memulai proses penyiapan, Anda dapat membantu orientasi mereka lebih cepat dan mengurangi frustrasi penyiapan pengguna.

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 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 Link Universal berikut:

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

Dengan agent-id sebagai Project ID integrasi Cloud ke 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 Link Universal, platform seluler akan memeriksa keberadaan GHA dan membuka alur penautan akun. Jika GHA tidak diinstal di perangkat pengguna, berikan penanganan penggantian untuk mengarahkan pengguna agar 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

Perbarui semua tombol dalam aplikasi dan situs produk untuk menggunakan Link Universal 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.