Introduzione all'API REST

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

Per utilizzare l'API REST Fitness, è importante comprendere le nozioni di base dei servizi web RESTful e delle rappresentazioni JSON.

Crea un account Google

Per utilizzare l'API REST per l'attività fisica, devi disporre di un Account Google. Se hai già un account, non devi fare altro. Ti consigliamo anche 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 console API di Google.
  2. Seleziona un progetto o creane uno nuovo. Usa lo stesso progetto per le versioni Android e REST dell'app.
  3. Fai clic su Continua per abilitare l'API Fitness.
  4. Fai clic su Go to credentials (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 OAuth Playground).
  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 e il nuovo secret OAuth 2.0 vengono visualizzati nell'elenco degli ID del 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 acquisire familiarità con l'API REST Fitness inviando richieste HTTP e osservando le risposte prima di scrivere qualsiasi codice client.

Per autorizzare l'API REST Fitness in OAuth Playground:

  1. Vai a OAuth Playground.
  2. Nel Passaggio 1: seleziona e autorizza le API, espandi Fitness v1 e seleziona gli ambiti 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 e modificare i dati associati all'account della console API di Google selezionato.
  4. Fai clic sul pulsante Scambia codice di autorizzazione 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 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 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 Request Body (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 Request Body (Corpo della richiesta), fai clic su Close (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

Utilizzare cURL per accedere all'API REST Fit

Puoi utilizzare lo strumento a riga di comando cURL per accedere all'API REST Fit. Avrai bisogno di un token di accesso OAuth per effettuare richieste utilizzando cURL (consulta le instructions precedenti). Tieni presente che i token di accesso scadono dopo un'ora. L'esempio seguente mostra 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: