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 Fitness, devi avere un Account Google. Se hai già un account, non devi fare altro. Potresti anche voler creare un Account Google separato a scopo 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 alle credenziali.
  5. Fai clic su Nuove credenziali, quindi 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 hanno origine 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, ad esempio:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Prova l'API REST in OAuth Playground

OAuth Playground è il modo più semplice per acquisire familiarità con il API REST Fitness inviando richieste HTTP e osservando le risposte prima devi scrivere qualsiasi codice client.

Per autorizzare l'API REST Fitness in OAuth Playground:

  1. Vai a OAuth Playground.
  2. Nel Passaggio 1, seleziona & Autorizza le API, espandi Fitness v1 e seleziona gli ambiti 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 e modificare i dati associati all'account della console API di Google selezionato.
  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 riposarti in forma API, 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 della richiesta, inserisci https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Fai clic su Invia la richiesta.

La richiesta e la risposta vengono visualizzate sul lato destro della pagina. Se è andata a buon fine, la risposta mostra l'origine dati della 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 Request Body (Corpo della richiesta), copia e incolla il seguente codice 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 API REST 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: