Derin bağlantı

Google Home app (GHA), kullanıcıların akıllı cihazları Google Assistant'ye bağlamak ve Google Home Graph'daki yapılara ve odalara atamak için kullandığı birincil yöntemdir. Kullanıcılar, kurulumu gerçekleştirmek için genellikle birden fazla ekranı tıklayarak mevcut seçenekler listesinden Cloud-to-cloud entegrasyonunuzu bulur. Kullanıcıların kurulum sürecine başlamasını kolaylaştırarak daha hızlı bir şekilde ilk katılım yapmalarına yardımcı olabilir ve kullanıcıların kurulumla ilgili yaşadığı hayal kırıklığını azaltabilirsiniz.

Derin bağlantı, kullanıcıların smart home cihazlarını Assistant cihazına kolayca bağlaması için uygulamanıza veya ürün web sitenize derin bağlantı yerleştirmenize olanak tanır. Bağlantıyı tıkladığınızda kullanıcılar GHA uygulamasını (yüklü değilse) indirmeye yönlendirilir ve hesap bağlama ile oda atama kurulum akışı başlatılır.

Google Home'a derin bağlantı

Derin bağlantılar, kullanıcıları Android veya iOS uygulamanızdan doğrudan GHA içindeki belirli bir hedefe yönlendirmenizi sağlayarak cihaz kurulum sürecini basitleştirir.

Hesap bağlama işlemini doğrudan GHA başlatmak için aşağıdaki evrensel bağlantıyı kullanın:

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

Burada agent-id, buluttan buluta entegrasyonunuzun proje kimliğidir. Bu kimliği, proje ayarları bölümündeki Google Home Developer Console altında bulabilirsiniz.

Özel şema (Android ve iOS) kullanılarak başlatılan mobil uygulamalar için şunları da kullanabilirsiniz:

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

Kullanıcılar geçiş bağlantısını tıkladığında mobil platform, GHA öğesinin varlığını kontrol eder ve hesap bağlama akışını açar. Kullanıcının cihazında GHA yüklü değilse kullanıcıyı Google Play veya Apple App Store'dan uygulamayı yüklemeye ya da güncellemeye yönlendirmek için yedek işleme sağlayın.

Android belirgin intent

Hesap bağlama akışını doğrudan Android uygulamanızdan belirgin intent kullanarak tetiklemek için:

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)
    }
}

madeby.google.com veya assistant.google.com ile biçimlendirilmiş eski derin bağlantı URL'leri kullanımdan kaldırıldı:

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

Tüm uygulama içi düğmeleri ve ürün web sitelerini, Geçiş Bağlantısı'nı veya googlehome://setup/ha_linking özel şemasını kullanacak şekilde güncelleyin.

Uygulamanızdan derin bağlantıları tetikleme hakkında daha fazla bilgi için ilgili Android dokümanlarına ve iOS dokümanlarına bakın.