الربط بصفحة معيّنة

Google Home app (GHA) هي الطريقة الأساسية التي يربط بها المستخدمون الأجهزة الذكية بخدمة Google Assistant ويخصّصونها للمباني والغرف في Google Home Graph. لإجراء عملية الإعداد، ينقر المستخدمون عادةً على شاشات متعدّدة للعثور على عملية الدمج Cloud-to-cloud من قائمة الخيارات المتاحة. من خلال تسهيل بدء عملية الإعداد على المستخدمين، يمكنك مساعدتهم في إكمال عملية الإعداد بشكل أسرع والحدّ من شعورهم بالإحباط.

تتيح لك ميزة "الربط العميق" تضمين رابط لصفحة في التطبيق أو الموقع الإلكتروني الخاص بالمنتج ليتمكّن المستخدمون من ربط جهاز smart home بسهولة بحساب Assistant. سيؤدي النقر على الرابط إلى مطالبة المستخدمين بتنزيل تطبيق GHA (إذا لم يكن مثبّتًا)، ثم سيتم تشغيل عملية إعداد ربط الحساب وتحديد الغرفة.

رابط لصفحة في تطبيق Google Home

تتيح لك الروابط لصفحات في التطبيق توجيه المستخدمين مباشرةً إلى وجهة معيّنة ضمن GHA من تطبيق Android أو تطبيق iOS، ما يسهّل عملية إعداد الجهاز.

لبدء ربط الحساب مباشرةً في GHA، استخدِم الرابط العام التالي:

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

حيث يمثّل agent-id رقم تعريف المشروع لعملية الدمج من السحابة الإلكترونية إلى السحابة الإلكترونية، ويمكنك العثور عليه في Google Home Developer Console ضمن إعدادات المشروع.

بالنسبة إلى تطبيقات الأجهزة الجوّالة التي يتم تشغيلها باستخدام مخطط مخصّص (Android وiOS)، يمكنك أيضًا استخدام:

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

عندما ينقر المستخدمون على الرابط العام، تتحقّق منصة الأجهزة الجوّالة من توفّر GHA وتفتح مسار ربط الحسابات. إذا لم يكن GHA مثبَّتًا على جهاز المستخدم، عليك توفير معالجة احتياطية لتوجيه المستخدم إلى تثبيت التطبيق أو تحديثه من Google Play أو Apple App Store.

Android explicit intent

لتفعيل مسار ربط الحسابات مباشرةً من تطبيق 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)
    }
}

الروابط القديمة لصفحات معيّنة

تم إيقاف عناوين URL القديمة للروابط لصفحات معيّنة المنسَّقة باستخدام madeby.google.com أو assistant.google.com:

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

تعديل جميع الأزرار داخل التطبيق ومواقع المنتجات الإلكترونية لاستخدام الرابط العام أو مخطط googlehome://setup/ha_linking المخصّص

لمزيد من التفاصيل حول تفعيل الروابط لصفحات في التطبيق من داخل تطبيقك، يُرجى الاطّلاع على مستندات Android ومستندات iOS ذات الصلة.