Erste Schritte mit der REST API

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

Es ist wichtig, dass Sie mit den Grundlagen von RESTful-Webdiensten und JSON-Darstellungen vertraut sind, um die Fitness REST API zu verwenden.

Erstellen Sie sich ein Google-Konto

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

OAuth 2.0-Client-ID anfordern

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

  1. Rufen Sie die Google API Console auf.
  2. Wählen Sie ein Projekt aus oder erstellen Sie ein neues. Verwenden Sie für die Android- und die REST-Version Ihrer App dasselbe Projekt.
  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 dann 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 Autorisierte Weiterleitungs-URI die URL der Website ein, auf der Antworten verarbeitet werden. https://developers.google.com/oauthplayground ist z. B. die URL, die vom OAuth Playground verwendet wird.

  9. Klicken Sie auf Erstellen. Deine neue OAuth 2.0-Client-ID und dein neues Secret werden in der Liste der IDs für dein Projekt angezeigt. Eine OAuth 2.0-Client-ID ist eine Zeichenfolge, die 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 und autorisieren 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 mit dem ausgewählten Google API Console-Konto verknüpften Daten zugreifen und diese ändern.
  4. Klicken Sie auf die Schaltfläche Autorisierungscode gegen Tokens austauschen. Der OAuth Playground fügt diesen Header automatisch in den Authorization:-Anfrageheader ein, wenn du HTTP-Anfragen sendest. Beachten Sie, dass das Zugriffstoken nach 60 Minuten (3.600 Sekunden) abläuft.

HTTP-Anfragen senden

Die folgenden Beispiele zeigen, wie HTTP-Anfragen gesendet werden, 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 listen Sie alle verfügbaren Datenquellen auf:

  1. Wählen Sie unter HTTP-Methode die Option GET aus.
  2. Geben Sie unter Anfrage-URI den Wert 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 ist, 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 POST aus.
  2. Geben Sie unter Anfrage-URI den Wert 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 und fügen Sie ihn ein:

    {
  "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

Sie können das cURL-Befehlszeilentool verwenden, um auf die Fit REST API zuzugreifen. Sie benötigen ein OAuth-Zugriffstoken, um Anfragen mit cURL zu senden (instructions). Beachten Sie, dass Zugriffstokens nach einer Stunde ablaufen. Das folgende Beispiel zeigt ein einfaches Bash-Skript zum Auflisten aller Datenquellen.

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

Nächste Schritte

Weitere Informationen zur REST API finden Sie auf diesen Seiten: