Начало работы с REST API

В этом руководстве показано, как активировать доступ к REST API Fitness, получить маркеры доступа OAuth и вызывать методы API с помощью HTTP-запросов.

Чтобы использовать Fitness REST API, важно понимать основы веб-служб RESTful и представлений JSON .

Получите учетную запись Google

Чтобы использовать Fitness REST API, вам потребуется учетная запись Google . Если у вас уже есть учетная запись, то все готово. Вы также можете создать отдельную учетную запись Google для целей тестирования.

Запрос идентификатора клиента OAuth 2.0

Выполните следующие действия, чтобы запросить идентификатор клиента OAuth 2.0 для Fitness API.

  1. Перейдите в консоль Google API .
  2. Выберите проект или создайте новый. Используйте один и тот же проект для версий вашего приложения для Android и REST.
  3. Нажмите « Продолжить» , чтобы включить фитнес-API.
  4. Щелкните Перейти к учетным данным .
  5. Нажмите «Новые учетные данные » и выберите «Идентификатор клиента OAuth ».
  6. В разделе Тип приложения выберите Веб-приложение .
  7. В разделе Авторизованные источники JavaScript введите базовый URL-адрес сайта, с которого будут исходить запросы (например, https://developers.google.com — это URL-адрес, используемый OAuth Playground).
  8. В разделе Авторизованный URI перенаправления введите URL-адрес сайта, на котором будут обрабатываться ответы (например, https://developers.google.com/oauthplayground — это URL-адрес, используемый игровой площадкой OAuth).
  9. Щелкните Создать . Ваш новый идентификатор клиента OAuth 2.0 и секрет появятся в списке идентификаторов вашего проекта. Идентификатор клиента OAuth 2.0 представляет собой строку символов, примерно такую:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Попробуйте REST API на игровой площадке OAuth

Площадка OAuth — это самый простой способ ознакомиться с REST API для фитнеса, отправляя HTTP-запросы и наблюдая за ответами, прежде чем писать какой-либо клиентский код.

Чтобы авторизовать Fitness REST API на игровой площадке OAuth:

  1. Перейдите на игровую площадку OAuth .
  2. В шаге 1 выберите и авторизуйте API -интерфейсы, разверните Fitness v1 и выберите области пригодности для использования.
  3. Нажмите кнопку « Авторизовать API », выберите проект Google API Console для использования и нажмите « Разрешить » при появлении запроса. Вы сможете получить доступ и изменить данные, связанные с выбранной учетной записью Google API Console.
  4. Нажмите кнопку Код авторизации Exchange для токенов . Площадка OAuth автоматически включает этот заголовок в заголовок Authorization: request при отправке HTTP-запросов. Обратите внимание, что срок действия токена доступа истекает через 60 минут (3600 секунд).

Отправлять HTTP-запросы

В следующих примерах показано, как отправлять HTTP-запросы для получения списка всех доступных источников данных и создания нового источника данных. Формат URI для Fitness REST API:

https://www.googleapis.com/fitness/v1/ resourcePath ? parameters

Чтобы вывести список всех доступных источников данных:

  1. В методе HTTP выберите ПОЛУЧИТЬ .
  2. В URI запроса введите https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Нажмите Отправить запрос .

Запрос и ответ отображаются в правой части страницы. Если запрос выполнен успешно, ответ показывает источник данных из предыдущего примера в формате JSON.

Чтобы создать источник данных:

  1. В методе HTTP выберите POST .
  2. В URI запроса введите https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Щелкните Ввести тело запроса .
  4. В окне « Текст запроса » скопируйте и вставьте следующий JSON:

    {
      "dataStreamName": "MyDataSource",
      "type": "derived",
      "application": {
        "detailsUrl": "http://example.com",
        "name": "Foo Example App",
        "version": "1"
      },
      "dataType": {
        "field": [
          {
            "name": "steps",
            "format": "integer"
          }
        ],
        "name": "com.google.step_count.delta"
      },
      "device": {
        "manufacturer": "Example Manufacturer",
        "model": "ExampleTablet",
        "type": "tablet",
        "uid": "1000001",
        "version": "1"
      }
    }
    
    
  5. В окне « Текст запроса » нажмите « Закрыть ».

  6. Нажмите Отправить запрос .

Запрос и ответ отображаются в правой части страницы. Запрос включает токен доступа OAuth в заголовок Authorization :

Authorization: Bearer ya29. OAuthTokenValue

Если запрос выполнен успешно, первая строка ответа:

HTTP/1.1 200 OK

Используйте cURL для доступа к Fit REST API.

Вы можете использовать инструмент командной строки cURL для доступа к Fit REST API. Вам понадобится токен доступа OAuth для выполнения запросов с использованием cURL (см. предыдущие инструкции ). Обратите внимание, что срок действия токенов доступа истекает через час. В следующем примере показан простой сценарий bash для вывода списка всех источников данных.

#!/bin/bash
ACCESS_TOKEN=""
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://www.googleapis.com/fitness/v1/users/me/dataSources

Следующие шаги

Чтобы узнать больше о REST API, см. эти страницы: