Pierwsze kroki z interfejsem API typu REST

Ten samouczek pokazuje, jak aktywować dostęp do interfejsu Fitness API REST, uzyskać tokeny dostępu OAuth i wywoływać metody interfejsu API za pomocą żądań HTTP.

Aby korzystać z interfejsu API typu REST Fitness, musisz znać podstawy usług internetowych typu REST i reprezentacji JSON.

Załóż konto Google

Aby korzystać z interfejsu Fitness API typu REST, potrzebujesz konta Google. Jeśli masz już konto, nie musisz nic robić. Do celów testowych możesz też utworzyć osobne konto Google.

Poproś o identyfikator klienta OAuth 2.0

Wykonaj te czynności, aby poprosić o identyfikator klienta OAuth 2.0 dla Fitness API.

  1. Otwórz Konsolę interfejsów API Google.
  2. Wybierz projekt lub utwórz nowy. Użyj tego samego projektu dla wersji aplikacji na Androida i REST.
  3. Kliknij Dalej, aby włączyć interfejs Fitness API.
  4. Kliknij Otwórz dane logowania.
  5. Kliknij Nowe dane logowania i wybierz Identyfikator klienta OAuth.
  6. W sekcji Typ aplikacji wybierz Aplikacja internetowa.
  7. W polu Autoryzowane źródła JavaScript wpisz podstawowy adres URL witryny, z której będą pochodzić żądania (np. https://developers.google.com to adres URL używany przez narzędzie OAuth Playground).
  8. W polu Identyfikator URI autoryzowanego przekierowania wpisz adres URL witryny, w której będą obsługiwane odpowiedzi (np. https://developers.google.com/oauthplayground to adres URL używany przez OAuth Playground).

  9. Kliknij Utwórz. Nowy identyfikator klienta OAuth 2.0 i tajny klucz pojawią się na liście identyfikatorów projektu. Identyfikator klienta OAuth 2.0 to ciąg znaków, na przykład taki:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Wypróbuj interfejs API REST w narzędziu OAuth Playground

OAuth Playground to najprostszy sposób, aby zapoznać się z interfejsem Fitness API REST. Możesz przesyłać żądania HTTP i obserwować odpowiedzi przed napisaniem kodu klienta.

Aby autoryzować interfejs Fitness REST API w narzędziu OAuth Playground:

  1. Otwórz narzędzie OAuth Playground.
  2. W sekcji Krok 1. Wybierz i autoryzuj interfejsy API rozwiń Fitness v1 i wybierz zakresy Fitness, których chcesz używać.
  3. Kliknij przycisk Autoryzuj interfejsy API, wybierz projekt Konsoli interfejsów API Google, którego chcesz użyć, i kliknij Zezwól, gdy pojawi się odpowiedni komunikat. Będziesz mieć dostęp do danych powiązanych z wybranym kontem w Konsoli interfejsów API Google i możliwość ich modyfikowania.
  4. Kliknij przycisk Exchange authorization code for tokens. OAuth Playground automatycznie umieszcza ten nagłówek w nagłówku żądania Authorization:, gdy przesyłasz żądania HTTP. Pamiętaj, że token dostępu wygasa po 60 minutach (3600 sekund).

Przesyłanie żądań HTTP

Poniższe przykłady pokazują, jak wysyłać żądania HTTP w celu wyświetlenia listy wszystkich dostępnych źródeł danych i utworzyć nowe źródło danych. W przypadku interfejsu Fitness REST API identyfikator URI ma następujący format:

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

Aby wyświetlić wszystkie dostępne źródła danych:

  1. W polu Metoda HTTP wybierz GET.
  2. W polu Identyfikator URI żądania wpisz https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Kliknij Wyślij prośbę.

Żądanie i odpowiedź pojawią się po prawej stronie. Jeśli żądanie zostanie zrealizowane, w odpowiedzi wyświetli się źródło danych z poprzedniego przykładu w formacie JSON.

Aby utworzyć źródło danych:

  1. W polu Metoda HTTP wybierz POST.
  2. W polu Identyfikator URI żądania wpisz https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Kliknij Wpisz treść żądania.

  4. W oknie Request Body (Treść żądania) skopiuj i wklej ten kod 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. W oknie Request Body (Treść żądania) kliknij Close (Zamknij).

  6. Kliknij Wyślij prośbę.

Żądanie i odpowiedź pojawią się po prawej stronie. Żądanie zawiera token dostępu OAuth w nagłówku Authorization:

Authorization: Bearer ya29.OAuthTokenValue

Jeśli żądanie zostanie zrealizowane, pierwszy wiersz odpowiedzi będzie wyglądać tak:

HTTP/1.1 200 OK

Użyj cURL, aby uzyskać dostęp do interfejsu Fit REST API

Aby uzyskać dostęp do interfejsu Fit REST API, możesz użyć narzędzia wiersza poleceń cURL. Aby wysyłać żądania za pomocą cURL, musisz mieć token dostępu OAuth (zobacz poprzednie instructions). Pamiętaj, że tokeny dostępu wygasają po godzinie. Poniższy przykład pokazuje prosty skrypt bash z listą wszystkich źródeł danych.

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

Dalsze kroki

Więcej informacji o interfejsie API REST znajdziesz na tych stronach: