Pierwsze kroki z interfejsem API typu REST

Ten samouczek pokazuje, jak aktywować dostęp do interfejsu Fitness API typu REST i uzyskać dostęp OAuth tokeny 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.

Żądanie identyfikatora 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 Go to credentials (Przejdź do danych 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órych będą pochodzić żądania (na przykład https://developers.google.com to adres URL używany przez OAuth Playground).
  8. W polu Autoryzowany identyfikator URI przekierowania wpisz adres URL witryny, z której będą pochodziły odpowiedzi. będzie obsługiwany (na przykład https://developers.google.com/oauthplayground to adres URL używany przez OAuth Playground).

  9. Kliknij Utwórz. Na liście pojawią się nowe identyfikatory klienta i klucz tajny OAuth 2.0 identyfikatorów projektów. Identyfikator klienta OAuth 2.0 to ciąg znaków, np.:

    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 do korzystania z zakresów Fitness.
  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). Protokół OAuth Playground automatycznie umieszcza ten nagłówek w elemencie Authorization: nagłówka żądania HTTP. Pamiętaj, że token dostępu wygasa po 60 minutach (3600 sekundach).

Przesyłanie żądań HTTP

Poniższe przykłady pokazują, jak wysyłać żądania HTTP, aby wyświetlić listę wszystkich dostępnych źródeł danych oraz do utworzenia nowego źródła danych. Na fitness REST API, format identyfikatora URI to:

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

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

  1. W polu HTTP Method (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 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 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 Treść żądania kliknij 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, by uzyskać dostęp do interfejsu API Fit REST

Możesz użyć narzędzia wiersza poleceń cURL, aby uzyskać dostęp do Interfejs API Fit typu REST. 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. Poniższy przykład pokazuje prosty skrypt bash do wyświetlenia listy 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: