Erste Schritte mit der REST API

In dieser Anleitung wird gezeigt, wie Sie den Zugriff auf die Fitness REST API aktivieren, OAuth-Zugriffstokens abrufen und die API-Methoden mit HTTP-Anfragen aufrufen.

Wenn Sie die Fitness REST API verwenden möchten, sollten Sie sich mit den Grundlagen von RESTful-Webdiensten und JSON-Darstellungen vertraut machen.

Erstellen Sie sich ein Google-Konto

Sie benötigen ein Google-Konto, um die Fitness REST API nutzen zu können. Wenn Sie bereits ein solches Konto haben, sind Sie schon startklar. Sie können zu Testzwecken auch ein separates Google-Konto erstellen.

OAuth 2.0-Client-ID anfordern

Führen Sie die folgenden Schritte aus, um eine OAuth 2.0-Client-ID für die Fitness API anzufordern.

  1. Rufe die Google API Console auf.
  2. Wählen Sie ein Projekt aus oder erstellen Sie ein neues. Verwenden Sie dasselbe Projekt für die Android- und die REST-Version Ihrer App.
  3. Klicken Sie auf Weiter, um die Fitness API zu aktivieren.
  4. Klicken Sie auf Zu den Anmeldedaten.
  5. Klicken Sie auf Neue Anmeldedaten und wählen Sie OAuth-Client-ID aus.
  6. Wählen Sie unter Anwendungstyp die Option Webanwendung aus.
  7. Geben Sie unter Autorisierte JavaScript-Quellen die Basis-URL der Website ein, von der Anfragen stammen. Beispiel: https://developers.google.com ist die URL, die vom OAuth Playground verwendet wird.
  8. Geben Sie unter Autorisierter Weiterleitungs-URI die URL der Website ein, auf der Antworten verarbeitet werden sollen. Beispiel: https://developers.google.com/oauthplayground ist die URL, die vom OAuth Playground verwendet wird.

  9. Klicken Sie auf Erstellen. Die neue OAuth 2.0-Client-ID und das neue OAuth-Secret werden in der Liste der IDs für Ihr Projekt angezeigt. Eine OAuth 2.0-Client-ID ist ein String, der in etwa so aussieht:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

REST API im OAuth Playground testen

Der OAuth Playground ist die einfachste Möglichkeit, sich mit der Fitness REST API vertraut zu machen. Dazu senden Sie HTTP-Anfragen und beobachten die Antworten, bevor Sie Clientcode schreiben.

So autorisieren Sie die Fitness REST API im OAuth Playground:

  1. Rufen Sie den OAuth Playground auf.
  2. Maximieren Sie unter Schritt 1 „APIs auswählen“ die Option Fitness v1 und wählen Sie die zu verwendenden Fitnessbereiche aus.
  3. Klicken Sie auf die Schaltfläche Authorize APIs (APIs autorisieren), wählen Sie das zu verwendende Google API Console-Projekt aus und klicken Sie auf Allow (Zulassen), wenn Sie dazu aufgefordert werden. Sie können auf die Daten zugreifen und sie ändern, die mit dem ausgewählten Google API Console-Konto verknüpft sind.
  4. Klicken Sie auf die Schaltfläche Exchange authorization code for tokens (Autorisierungscode für Tokens austauschen). Der OAuth-Playground fügt diesen Header automatisch in den Authorization:-Anfrageheader ein, wenn Sie HTTP-Anfragen senden. Das Zugriffstoken läuft nach 60 Minuten (3.600 Sekunden) ab.

HTTP-Anfragen senden

In den folgenden Beispielen wird gezeigt, wie Sie HTTP-Anfragen senden, um alle verfügbaren Datenquellen aufzulisten und eine neue Datenquelle zu erstellen. Für die Fitness REST API lautet das URI-Format:

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

So rufen Sie alle verfügbaren Datenquellen auf:

  1. Wählen Sie unter HTTP-Methode die Option GET aus.
  2. Geben Sie unter Anfrage-URI https://www.googleapis.com/fitness/v1/users/me/dataSources ein.
  3. Klicken Sie auf Anfrage senden.

Die Anfrage und die Antwort werden rechts auf der Seite angezeigt. Wenn die Anfrage erfolgreich war, wird in der Antwort die Datenquelle aus dem vorherigen Beispiel im JSON-Format angezeigt.

So erstellen Sie eine Datenquelle:

  1. Wählen Sie unter HTTP-Methode die Option POSTEN aus.
  2. Geben Sie unter Anfrage-URI https://www.googleapis.com/fitness/v1/users/me/dataSources ein.
  3. Klicken Sie auf Anfragetext eingeben.

  4. Kopieren Sie im Fenster Anfragetext den folgenden JSON-Code:

    {
  "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. Klicken Sie im Fenster Anfragetext auf Schließen.

  6. Klicken Sie auf Anfrage senden.

Die Anfrage und die Antwort werden rechts auf der Seite angezeigt. Die Anfrage enthält das OAuth-Zugriffstoken im Header Authorization:

Authorization: Bearer ya29.OAuthTokenValue

Wenn die Anfrage erfolgreich ist, lautet die erste Zeile der Antwort:

HTTP/1.1 200 OK

Mit cURL auf die Fit REST API zugreifen

Mit dem cURL-Befehlszeilentool können Sie auf die Fit REST API zugreifen. Sie benötigen ein OAuth-Zugriffstoken für Anfragen mit cURL (siehe vorherige Anleitung). Hinweis: Zugriffstokens laufen nach einer Stunde ab. Das folgende Beispiel zeigt ein einfaches Bash-Skript, mit dem alle Datenquellen aufgelistet werden.

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

Weitere Informationen

Weitere Informationen zur REST API finden Sie auf den folgenden Seiten: