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

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.

الـ explicit intent في 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)
    }
}

الروابط العميقة القديمة

تم إيقاف عناوين 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 ذات الصلة.