Introduzione all'API REST

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

Per utilizzare l'API Fitness REST è importante che tu comprenda le nozioni di base di servizi web RESTful e rappresentazioni JSON.

Crea un account Google

Per usare l'API Fitness REST devi avere un Account Google. Se hai già un account, non devi fare altro. Puoi anche 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 console API di Google.
  2. Seleziona un progetto o creane uno nuovo. Utilizza lo stesso progetto per le versioni Android e REST della tua app.
  3. Fai clic su Continua per abilitare l'API Fitness.
  4. Fai clic su Vai alle credenziali.
  5. Fai clic su Nuove credenziali e 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 Playground OAuth).
  8. In URI di reindirizzamento autorizzato, inserisci l'URL del sito in cui verranno gestite le risposte (ad esempio https://developers.google.com/oauthplayground è l'URL utilizzato da OAuth Playground).

  9. Fai clic su Crea. Il nuovo ID client OAuth 2.0 e il secret vengono visualizzati nell'elenco di ID del progetto. Un ID client OAuth 2.0 è una stringa di caratteri simile alla seguente:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Prova l'API REST in OAuth Playground

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

Per autorizzare l'API Fitness REST in OAuth Playground:

  1. Vai a OAuth Playground.
  2. In Passaggio 1, seleziona e autorizza le API, espandi Fitness v1 e seleziona gli ambiti di fitness da utilizzare.
  3. Fai clic sul pulsante Autorizza API, seleziona il progetto della console API di Google da utilizzare e fai clic su Consenti quando richiesto. Potrai accedere ai dati associati all'account Google Console selezionato e modificarli.
  4. Fai clic sul pulsante Codice di autorizzazione di Exchange per i token. OAuth Playground include automaticamente questa intestazione nell'intestazione della richiesta Authorization: quando invii richieste HTTP. Tieni presente che il token di accesso scade dopo 60 minuti (3600 secondi).

Inviare richieste HTTP

I seguenti esempi mostrano come inviare richieste HTTP per elencare tutte le origini dati disponibili e per creare una nuova origine dati. Per l'API REST fitness, 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 la richiesta ha esito positivo, 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 Richiedi corpo, 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 Richiedi corpo, 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

Usa cURL per accedere all'API Fit REST

Puoi utilizzare lo strumento a riga di comando cURL per accedere all'API REST di Fit. Per effettuare richieste utilizzando cURL, devi disporre di un token di accesso OAuth (consulta le istruzioni precedenti). Tieni presente che i token di accesso scadono dopo un'ora. L'esempio seguente mostra uno script bash semplice 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 scoprire di più sull'API REST, consulta queste pagine: