딥 링크

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는 프로젝트 설정에서 확인할 수 있는 클라우드 간 통합의 프로젝트 ID입니다.Google Home Developer Console

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

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

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

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 문서를 참고하세요.