Многие, вероятно, не в курсе, что у колонок Google есть свой локальный API. Я сейчас говорю не про протокол Chromecast, который бесспорно хорош. Я говорю про API, который позволяет настраивать колонки Google с помощью мобильного приложения Google Home.

Первая информация об этом протоколе появилась в январе 2018 года. API можно было свободно пользоваться в пределах локальной сети.

В январе 2019 года Google выпустил обновление, добавляющее обязательную авторизацию. Для выполнения команд требовался локальный токен — прям как в колонках Яндекса. В сообществе нашли решение в виде запуска виртуальной машины с рутованным Android, а затем извлечение токена из приложения Google Home по adb. Сложность такого подхода заставила многих отказаться от этого API.

И вот совсем недавно автор неофициальной документации локального API предложил более цивилизованный способ получить локальный токен — с помощью логина и пароля от Google-аккаунта.

Сперва необходимо получить master-токен для своего аккаунта Google. Для этого нужно притвориться Android-приложением от Google, используя библиотеку gpsoauth (Google Play Services OAuth). Для безопасности можно создать и использовать пароль приложений Google вместо своего основного пароля. И в итоге сохранить только токен. Он выдаётся надолго.

Затем, используя ту же библиотеку, получить access-токен. И уже с его помощью, используя утилиту gRPCurl и предложенный автором файл proto, получить ваш Home Graph.

Home Graph сам по себе очень интересен: он содержит полную информацию о вашем умном доме Google, включая список устройств, комнат, локацию во всех подробностях. В Home Graph есть локальные токены колонок.

Ещё там есть список типов устройств, которые потенциально собирается поддерживать Google. Я насчитал 130 штук, и среди них есть “устройства” кошка и собака...

Так чем же хорош локальный API? С его помощью можно узнавать список будильников и удалять их (создавать нельзя). Можно управлять эквалайзером и режимом “не беспокоить”. Но самое интересное — можно запускать поиск окружающих устройств Bluetooth.

В списке Bluetooth-устройств будет MAC-адрес и мощность сигнала. И по возможности — имя и класс устройства.

На этих данных можно построить “логику присутствия”. Конечно, при условии, что ваши устройстройства дают себя обнаружить. В Home Assistant когда-то давно был как раз такой компонент, но его удалили после появления авторизации в API.

Если в вашем доме несколько Google-колонок, можно попытаться реализовать позиционирование человека в пределах квартиры.

У меня достаточно много проектов, чтоб заняться ещё и этим. Но надеюсь, кто-нибудь воспользуется этими знаниями и сделает что-то прикольное для себя, а может, и для сообщества.