Pierwsze kroki z interfejsem API typu REST

Z tego samouczka dowiesz się, jak aktywować dostęp do interfejsu Fitness REST API, uzyskać tokeny dostępu OAuth i wywoływać metody interfejsu API za pomocą żądań HTTP.

Aby korzystać z interfejsu Fitness API typu REST, musisz znać podstawy Usługi internetowe REST i reprezentacje JSON.

Załóż konto Google

Aby korzystać z interfejsu API Fitness typu REST, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic robić. Możesz także utworzyć oddzielne konto Google do celów testowych.

Prośba o identyfikator klienta OAuth 2.0

Wykonaj te kroki, aby zażądać identyfikatora klienta OAuth 2.0 dla interfejsu Fitness API.

  1. Przejdź do Konsola interfejsów API Google.
  2. Wybierz projekt lub utwórz nowy. Użyj tego samego projektu na Androidzie i wersji REST swojej aplikacji.
  3. Kliknij Dalej, aby włączyć interfejs Fitness API.
  4. Kliknij Przejdź do danych logowania.
  5. Kliknij Nowe dane logowania, a następnie 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órych będą pochodzić żądania (na przykład https://developers.google.com to adres URL używany przez OAuth Playground).
  8. W sekcji Autoryzowany identyfikator URI przekierowania wpisz adres URL witryny, w której będą obsługiwane odpowiedzi (na przykład https://developers.google.com/oauthplayground jest adresem URL używanym przez narzędzie OAuth Playground).

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

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

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

Protokół OAuth Playground to najprostszy sposób na zapoznanie się z Fitness REST API, przesyłając żądania HTTP i obserwując odpowiedzi przed w napisaniu dowolnego kodu klienta.

Aby autoryzować interfejs Fitness API typu REST w interfejsie OAuth Playground:

  1. Otwórz stronę 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 Authorize APIs i wybierz projekt Konsoli interfejsów API Google, i kliknij Zezwól, gdy pojawi się odpowiedni komunikat. Będziesz mieć dostęp do modyfikować dane powiązane z wybranym kontem Konsoli interfejsów API Google.
  4. Kliknij przycisk Exchange authorization code for token (Kod autoryzacji giełdy dla tokenów). Platforma OAuth Playground automatycznie dołącza ten nagłówek do nagłówka Authorization: żądania, gdy przesyłasz żądania HTTP. Pamiętaj, że token dostępu wygasa po 60 minutach (3600 sekundach).

Przesyłanie żądań HTTP

W podanych niżej przykładach pokazujemy, jak wysyłać żądania HTTP, aby wyświetlić listę wszystkich dostępnych źródeł danych i utworzyć nowe źródło danych. W przypadku interfejsu API Fitness w formacie REST:

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

Aby wyświetlić listę wszystkich dostępnych źródeł danych:

  1. Jako 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 strony. Jeśli żądanie zostało zrealizowane, odpowiedź pokazuje źródło danych z poprzedniego przykład w formacie JSON.

Aby utworzyć źródło danych:

  1. W polu HTTP Method (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 Treść żądania wklej ten fragment kodu 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 Treść żądania kliknij Zamknij.

  6. Kliknij Wyślij prośbę.

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

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, by uzyskać dostęp do interfejsu API Fit REST

Aby uzyskać dostęp do interfejsu Fit REST API, możesz użyć narzędzia wiersza poleceń cURL. Aby wysyłać żądania, potrzebujesz tokena dostępu OAuth używając cURL (zobacz poprzednie instrukcje). Pamiętaj, że tokeny dostępu wygasają po godzinie. Ten przykład pokazuje prosty skrypt bash do wylistowania 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: