Introduzione all'API REST

Questo tutorial mostra come attivare l'accesso all'API REST Fitness, ottenere l'accesso OAuth e richiamare i metodi dell'API mediante richieste HTTP.

Per utilizzare l'API REST Fitness, è importante conoscere le nozioni di base Servizi web RESTful e le rappresentazioni JSON.

Come procurarsi un account Google

Per utilizzare l'API REST di Fitness, devi disporre di un Account Google. Se hai già un account, è tutto pronto. Ti consigliamo inoltre di creare un Account Google separato per scopi di test.

Richiedere un ID client OAuth 2.0

Segui questi passaggi per richiedere un ID client OAuth 2.0 per l'API Fitness.

  1. Vai alla pagina Console API di Google.
  2. Seleziona un progetto o creane uno nuovo. Utilizza lo stesso progetto per Android e REST dell'app.
  3. Fai clic su Continua per abilitare l'API Fitness.
  4. Fai clic su Vai a credenziali.
  5. Fai clic su Nuove credenziali e poi seleziona ID client OAuth.
  6. In Tipo di applicazione, seleziona Applicazione web.
  7. In Origini JavaScript autorizzate, inserisci l'URL di base del sito da cui partiranno le richieste (ad esempio https://developers.google.com è l'URL utilizzato da OAuth Playground).
  8. In URI di reindirizzamento autorizzato, inserisci l'URL del sito in cui le risposte verrà gestito (ad esempio https://developers.google.com/oauthplayground è l'URL utilizzato da OAuth Playground).

  9. Fai clic su Crea. Il nuovo ID client e il tuo nuovo secret OAuth 2.0 vengono visualizzati nell'elenco di ID per il tuo progetto. Un ID client OAuth 2.0 è una stringa di caratteri, simile a questa:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Prova l'API REST in OAuth Playground

OAuth Playground è il modo più semplice per familiarizzare con l'API REST di Fitness inviando richieste HTTP e osservando le risposte prima di scrivere il codice client.

Per autorizzare l'API REST Fitness in OAuth Playground:

  1. Vai a OAuth Playground.
  2. In Passaggio 1 Seleziona e autorizza le API, espandi Fitness v1 e seleziona gli scopi di Fitness da utilizzare.
  3. Fai clic sul pulsante Autorizza API, seleziona il progetto della console API di Google da use e fai clic su Consenti quando richiesto. Potrai accedere ai dati associati all'account della console API di Google selezionato e modificarli.
  4. Fai clic sul pulsante Exchange Authorization code for tokens (Scambia codice di autorizzazione per i token). Il protocollo OAuth Playground include automaticamente questa intestazione in Authorization: quando invii le richieste HTTP. Tieni presente che il token di accesso scadrà dopo 60 minuti (3600 secondi).

Invia richieste HTTP

I seguenti esempi mostrano come inviare richieste HTTP per elencare tutte le origini dati disponibili e per crearne una nuova. Per l'API Fitness REST, il formato dell'URI è:

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

Per elencare tutte le origini dati disponibili:

  1. In Metodo HTTP, seleziona GET.
  2. In URI richiesta, inserisci https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Fai clic su Invia richiesta.

La richiesta e la risposta vengono visualizzate sul lato destro della pagina. Se la richiesta riesce, la risposta mostra l'origine dati dell'esempio precedente in formato JSON.

Per creare un'origine dati:

  1. In Metodo HTTP, seleziona POST.
  2. In URI della richiesta, inserisci https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Fai clic su Inserisci il corpo della richiesta.

  4. Nella finestra Corpo della richiesta, copia e incolla il seguente 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. Nella finestra Corpo della richiesta, fai clic su Chiudi.

  6. Fai clic su Invia la richiesta.

La richiesta e la risposta vengono visualizzate sul lato destro della pagina. La richiesta include il token di accesso OAuth nell'intestazione Authorization:

Authorization: Bearer ya29.OAuthTokenValue

Se la richiesta ha esito positivo, la prima riga della risposta è:

HTTP/1.1 200 OK

Utilizza cURL per accedere all'API REST Fit

Puoi utilizzare lo strumento a riga di comando cURL per accedere all'API REST di Fit. Avrai bisogno di un token di accesso OAuth per effettuare richieste utilizzando cURL (consulta le istruzioni precedenti). Tieni presente che i token di accesso scadono dopo un'ora. L'esempio seguente mostra un un semplice script bash per elencare tutte le origini dati.

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

Passaggi successivi

Per saperne di più sull'API REST, consulta queste pagine: