딥 링크

Google Home app (GHA)는 사용자가 스마트 기기를 Google Assistant에 연결하고 Google Home Graph의 집과 방에 할당하는 기본 방법입니다. 설정을 수행하려면 사용자는 일반적으로 여러 화면을 클릭하여 사용 가능한 옵션 목록에서 Cloud-to-cloud 통합을 찾습니다. 사용자가 설정 프로세스를 더 쉽게 시작할 수 있도록 하면 더 빠르게 온보딩하고 사용자 설정 불만을 줄일 수 있습니다.

딥 링크를 사용하면 사용자가 smart home 기기를 Assistant에 쉽게 연결할 수 있도록 앱 또는 제품 웹사이트에 딥 링크를 삽입할 수 있습니다. 링크를 클릭하면 사용자에게 GHA를 다운로드하라는 메시지가 표시되고 (아직 설치되지 않은 경우) 계정 연결 및 방 할당 설정 흐름이 실행됩니다.

Google Home으로 연결되는 딥 링크

딥 링크를 사용하면 Android 또는 iOS 앱에서 GHA 내의 특정 대상으로 사용자를 직접 안내하여 기기 설정 프로세스를 간소화할 수 있습니다.

GHA에서 직접 계정 연결을 시작하려면 다음 범용 링크를 사용하세요.

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

여기서 agent-id는 Cloud-to-Cloud 통합의 프로젝트 ID이며, 프로젝트 설정의 Google Home Developer Console에서 찾을 수 있습니다.

맞춤 스키마 (Android 및 iOS)를 사용하여 실행되는 모바일 애플리케이션의 경우 다음을 사용할 수도 있습니다.

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

사용자가 범용 링크를 클릭하면 모바일 플랫폼에서 GHA가 있는지 확인하고 계정 연결 과정을 엽니다. GHA가 사용자의 기기에 설치되어 있지 않은 경우 사용자가 Google Play 또는 Apple 앱 스토어에서 앱을 설치하거나 업데이트하도록 라우팅하는 대체 처리를 제공합니다.

Android 명시적 인텐트

명시적 인텐트를 사용하여 Android 애플리케이션에서 직접 계정 연결 흐름을 트리거하려면 다음 단계를 따르세요.

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 또는 assistant.google.com로 형식이 지정된 기존 딥 링크 URL은 지원 중단되었습니다.

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

범용 링크 또는 googlehome://setup/ha_linking 맞춤 스킴을 사용하도록 모든 인앱 버튼과 제품 웹사이트를 업데이트합니다.

앱 내에서 딥 링크를 트리거하는 방법에 관한 자세한 내용은 관련 Android 문서 및 iOS 문서를 참고하세요.