Erste Schritte mit der REST API

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

Um die Fitness REST API verwenden zu können, ist es wichtig, dass Sie die Grundlagen RESTful-Webdienste und JSON-Darstellungen.

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. Vielleicht möchten Sie auch Erstellen Sie zu Testzwecken ein separates Google-Konto.

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. Gehe zu Google API Console.
  2. Wählen Sie ein Projekt aus oder erstellen Sie ein neues. Verwenden Sie dasselbe Projekt für die Android-App und REST-Versionen 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 denen die Anfragen stammen (z. B. https://developers.google.com) die vom OAuth Playground verwendete URL ist).
  8. Geben Sie unter Autorisierter Weiterleitungs-URI die URL der Website ein, auf der Antworten verarbeitet werden (z. B. https://developers.google.com/oauthplayground) die vom OAuth Playground verwendete URL ist).

  9. Klicken Sie auf Erstellen. Ihre neue OAuth 2.0-Client-ID und Ihr neues OAuth-2.0-Secret werden in der Liste angezeigt für Ihr Projekt. Eine OAuth 2.0-Client-ID ist eine Zeichenfolge, etwa so:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

REST API im OAuth Playground testen

Der OAuth Playground ist die einfachste Möglichkeit, sich mit den Fitness REST API durch Senden von HTTP-Anfragen und Beobachten der Antworten vor Clientcode schreiben.

So autorisieren Sie die Fitness REST API im OAuth Playground:

  1. Rufen Sie den OAuth Playground auf.
  2. Wählen Sie unter Schritt 1 autorisieren Sie APIs, maximieren Sie Fitness v1 und wählen Sie die zu verwendenden Fitness-Bereiche.
  3. Klicken Sie auf die Schaltfläche Authorize APIs (APIs autorisieren) und wählen Sie das Google API Console-Projekt aus, und klicken Sie bei Aufforderung auf Zulassen. Sie haben Zugriff auf Daten ändern, die mit dem ausgewählten Google API Console-Konto verknüpft sind.
  4. Klicken Sie auf die Schaltfläche Autorisierungscode gegen Tokens austauschen. Das OAuth Playground fügt diesen Header automatisch in den Authorization: ein , wenn Sie HTTP-Anfragen senden. Das Zugriffstoken laufen nach 60 Minuten (3.600 Sekunden) ab.

HTTP-Anfragen senden

Die folgenden Beispiele zeigen, wie HTTP-Anfragen gesendet werden, um alle Datenquellen verfügbar sind und eine neue Datenquelle erstellt werden kann. Für 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 erfolgreich war, wird in der Antwort die Datenquelle aus der vorherigen Beispiel im JSON-Format.

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 Request Body (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 in den Authorization-Header:

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 den Fit REST API Für Anfragen benötigen Sie ein OAuth-Zugriffstoken. mithilfe von cURL (siehe vorherige Anleitung). Beachten Sie, dass Zugriffstokens nach einer Stunde ablaufen. Das folgende Beispiel zeigt eine 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: