Начать работу на Android

Получить аккаунт Google

Чтобы использовать API Google Fit, вам понадобится учетная запись Google. Вы можете создать новую учетную запись или использовать существующую учетную запись. Возможно, вы захотите создать отдельную учетную запись, чтобы протестировать свое приложение с точки зрения пользователя.

Получить сервисы Google Play

Получите последнюю клиентскую библиотеку для сервисов Google Play на своем хосте разработки:

1. Откройте диспетчер Android SDK .
2. В разделе «Инструменты SDK» найдите сервисы Google Play .
3. Если статус этих пакетов не «Установлен» , выберите их оба и нажмите «Установить пакеты» .

Получите идентификатор клиента OAuth 2.0.

Чтобы включить Fitness API, получите идентификатор клиента OAuth 2.0 .

Создайте и настройте свой проект

Мы рекомендуем использовать среду разработки Android Studio для создания приложения с помощью Fitness API. Подробности о том, как создать новый проект и настроить его в Android Studio, см. в разделе Создание проекта .

Добавьте клиентскую библиотеку сервисов Google Play.

В Android Studio откройте файл build.gradle для вашего модуля и добавьте клиентскую библиотеку сервисов Google Play в качестве зависимости:

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.2.0")
        implementation("com.google.android.gms:play-services-auth:21.2.0")
}

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.2.0'
    implementation 'com.google.android.gms:play-services-auth:21.2.0'
}

Это гарантирует, что Gradle автоматически загрузит фитнес-SDK при создании вашего приложения.

Получите необходимые разрешения Android

Чтобы читать и записывать некоторые типы данных , вашему приложению необходимо запросить разрешения Android .

Получите разрешения OAuth

Типы данных, к которым у вашего приложения есть разрешение, соответствуют областям авторизации . Чтобы запросить эти разрешения, вам необходимо добавить, к каким типам данных ваше приложение должно иметь доступ, в экземпляре FitnessOptions . Когда ваше приложение запрашивает использование любого типа данных Google Fit, Android SDK автоматически проверяет, к каким областям они принадлежат, и запрашивает у пользователя авторизацию для этих областей.

Создайте API-клиент

Создайте клиент API и добавьте типы данных, к которым ваше приложение должно иметь доступ для записи или чтения данных. Доступны следующие конечные точки:

• SensorsClient : доступ к различным источникам данных о здоровье и самочувствии от аппаратных датчиков на локальном устройстве и сопутствующих устройствах.
• RecordingClient : для непрерывного фонового сбора данных с датчиков с низким энергопотреблением.
• HistoryClient : вставка, удаление и чтение исторических данных в Google Fit.
• SessionsClient : создание сеансов активности пользователей и управление ими.
• GoalsClient : чтение целей Heart Point и Steps, созданных пользователями в Google Fit.
• ConfigClient : доступ к пользовательским типам данных и настройкам на платформе Google Fit.

См. пример создания клиента Fitness API.

Результирующий поток авторизации пользователя

Ниже показан результирующий поток авторизации, с которым сталкиваются пользователи, когда у них запрашиваются разрешения:

1. Разрешения Android . Пользователи видят, какие разрешения Android запрашивает ваше приложение, прежде чем загружать его. После загрузки вашего приложения оно запрашивает все необходимые ему разрешения во время выполнения, а пользователи предоставляют или отклоняют эти разрешения.
2. Проверить и подключиться : ваше приложение проверяет, были ли предоставлены разрешения, прежде чем запрашивать доступ к другим типам данных.
3. Запрос областей OAuth . Google предлагает пользователю предоставить вашему приложению области OAuth, необходимые для типов данных, к которым оно хочет получить доступ.
4. Доступ применен : после того, как пользователь предоставит разрешения, ваше приложение сможет получить доступ к типам данных, принадлежащим областям, для которых пользователь предоставил разрешения.