Pierwsze kroki z interfejsem API REST

W tym samouczku pokazujemy, jak aktywować dostęp do interfejsu API API typu REST, uzyskać tokeny OAuth i wywołać metody interfejsu API za pomocą żądań HTTP.

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

Załóż konto Google

Aby korzystać z fitness API REST, musisz mieć konto Google. Jeśli masz już konto, nie musisz nic więcej robić. Możesz też utworzyć osobne konto Google na potrzeby testów.

Żądanie identyfikatora klienta OAuth 2.0

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

  1. Otwórz Konsolę interfejsów API Google.
  2. Wybierz projekt lub utwórz nowy. Użyj tego samego projektu w wersjach aplikacji na Androida i REST.
  3. Kliknij Dalej, aby włączyć Fitness API.
  4. Kliknij Przejdź do danych logowania.
  5. Kliknij Nowe dane logowania i wybierz Identyfikator klienta OAuth.
  6. W sekcji Typ aplikacji wybierz Aplikacja internetowa.
  7. W sekcji Autoryzowane źródła JavaScriptu wpisz podstawowy adres URL witryny, z której będą wysyłane żą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 (np. https://developers.google.com/oauthplayground będzie adresem URL używanym 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 podobny do tego:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Wypróbuj interfejs API REST w środowisku Play OAuth

OAuth Playground to najprostszy sposób na zapoznanie się z interfejsem API Fit typu REST przez przesłanie żądań HTTP i obserwowanie odpowiedzi przed napisaniem kodu klienta.

Aby autoryzować interfejs API REST Fitness w placówce OAuth Playground:

  1. Otwórz Play OAuthground.
  2. W sekcji Krok 1 wybierz i autoryzuj interfejsy API rozwiń Fitness v1 i wybierz zakresy fitness do użycia.
  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ę taka prośba. Będziesz mieć dostęp do danych powiązanych z wybranym kontem Konsoli interfejsów API Google i może je modyfikować.
  4. Kliknij przycisk Kod autoryzacji Exchange dla tokenów. Protokół OAuth Playground automatycznie umieszcza ten nagłówek w nagłówku żądania Authorization: podczas przesyłania żądań HTTP. Pamiętaj, że token dostępu wygaśnie po 60 minutach (3600 sekund).

Przesyłanie żądań HTTP

Poniższe przykłady pokazują, jak wysyłać żądania HTTP, aby wyświetlić wszystkie dostępne źródła danych i utworzyć nowe źródło danych. W przypadku Fitness API REST Format identyfikatora URI to:

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

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

  1. W sekcji 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ź są widoczne po prawej stronie. Jeśli żądanie się powiedzie, odpowiedź będzie zawierać źródło danych z poprzedniego przykładu w formacie JSON.

Aby utworzyć źródło danych:

  1. W polu Metoda HTTP wybierz POST (OPUBLIKUJ).
  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ź są widoczne po prawej stronie. Żądanie zawiera token dostępu OAuth w nagłówku Authorization:

Authorization: Bearer ya29.OAuthTokenValue

Jeśli żądanie jest udane, pierwszy wiersz odpowiedzi to:

HTTP/1.1 200 OK

Aby otworzyć interfejs Fit REST API, użyj cURL

Aby uzyskać dostęp do interfejsu API Fit typu REST, możesz użyć narzędzia wiersza poleceń cURL. Do wykonywania żądań przy użyciu cURL będziesz potrzebować tokena dostępu OAuth (zobacz poprzednie instrukcje). Pamiętaj, że tokeny dostępu wygasają po godzinie. Poniższy przykład przedstawia prosty skrypt bash zawierający 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: