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.
- Gehe zu Google API Console.
- 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.
- Klicken Sie auf Weiter, um die Fitness API zu aktivieren.
- Klicken Sie auf Zu den Anmeldedaten.
- Klicken Sie auf Neue Anmeldedaten und wählen Sie OAuth-Client-ID aus.
- Wählen Sie unter Anwendungstyp die Option Webanwendung aus.
- 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). - 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). 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:
- Rufen Sie den OAuth Playground auf.
- Wählen Sie unter Schritt 1 autorisieren Sie APIs, maximieren Sie Fitness v1 und wählen Sie die zu verwendenden Fitness-Bereiche.
- 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.
- 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:
- Wählen Sie unter HTTP-Methode die Option GET aus.
- Geben Sie unter Anfrage-URI den Wert
https://www.googleapis.com/fitness/v1/users/me/dataSources
ein. - 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:
- Wählen Sie unter HTTP-Methode die Option POST aus.
- Geben Sie unter Anfrage-URI den Wert
https://www.googleapis.com/fitness/v1/users/me/dataSources
ein. - Klicken Sie auf Anfragetext eingeben.
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" } }
Klicken Sie im Fenster Anfragetext auf Schließen.
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: