Le API Google Fit, inclusa l'API REST Google Fit, non saranno più disponibili dopo il 30 giugno 2025. A partire dal 1° maggio 2024, gli sviluppatori non possono registrarsi per utilizzare queste API.

Per istruzioni sull'API o sulla piattaforma verso cui eseguire la migrazione, visita la guida alla migrazione di Connessione Salute. Per un confronto tra Connessione Salute con le API Google Fit e le API web di Fitbit, visita la guida al confronto di Connessione Salute.

Scopri di più su Connessione Salute e su come eseguire l'integrazione con l'API.

Questa pagina è stata tradotta dall'API Cloud Translation.

Users.dataSources.datasets

Un set di dati rappresenta un container di proiezione per i punti dati. Non includono informazioni proprie. I set di dati rappresentano un insieme di punti dati di una determinata origine dati. Un punto dati può essere trovato in più di un set di dati.

Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.

Rappresentazioni delle risorse

{
  "minStartTimeNs": long,
  "maxEndTimeNs": long,
  "dataSourceId": string,
  "point": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "nextPageToken": string
}

Nome proprietà	Valore	Descrizione
`dataSourceId`	`string`	L'ID stream di dati dell'origine dati che ha creato i punti in questo set di dati.
`maxEndTimeNs`	`long`	L'ora di fine più grande di tutti i punti dati in questa rappresentazione potenzialmente parziale del set di dati. L'epoca è espressa in nanosecondi. Dovrebbe corrispondere anche alla seconda parte dell'identificatore del set di dati.
`minStartTimeNs`	`long`	L'ora di inizio più piccola di tutti i punti dati in questa rappresentazione potenzialmente parziale del set di dati. L'epoca è espressa in nanosecondi. Dovrebbe corrispondere anche alla prima parte dell'identificatore del set di dati.
`nextPageToken`	`string`	Questo token verrà impostato quando un set di dati viene ricevuto in risposta a una richiesta GET e il set di dati è troppo grande per essere incluso in un'unica risposta. Fornisci questo valore in una richiesta GET successiva per restituire la pagina successiva dei punti dati all'interno di questo set di dati.
`point[]`	`list`	Un elenco parziale dei punti dati contenuti nel set di dati, ordinati per endTimeNanos. Questo elenco è considerato completo quando si recupera un set di dati di piccole dimensioni e parziale quando si applica la patch a un set di dati o quando si recupera un set di dati troppo grande per essere incluso in una singola risposta.
`point[].computationTimeMillis`	`long`	NON UTILIZZARE QUESTO CAMPO. Viene ignorato e non viene memorizzato.
`point[].dataTypeName`	`string`	Il tipo di dati che definisce il formato dei valori in questo punto dati.
`point[].endTimeNanos`	`long`	L'ora di fine dell'intervallo rappresentato da questo punto dati, in nanosecondi dall'epoca.
`point[].modifiedTimeMillis`	`long`	Indica l'ultima volta che questo punto dati è stato modificato. È utile solo in contesti in cui vengono elencate le modifiche apportate ai dati, anziché lo stato attuale dei dati.
`point[].originDataSourceId`	`string`	Se il punto dati è contenuto in un set di dati per un'origine dati derivata, questo campo verrà completato con l'ID stream dell'origine dati che ha creato in origine il punto dati. AVVISO: non fare affidamento su questo campo per scopi diversi dal debug. Il valore di questo campo, se impostato, rappresenta un dettaglio di implementazione e non è garantito che rimanga coerente.
`point[].rawTimestampNanos`	`long`	Il timestamp non elaborato dell'evento SensorEvent originale.
`point[].startTimeNanos`	`long`	L'ora di inizio dell'intervallo rappresentato da questo punto dati, in nanosecondi dall'epoca.
`point[].value[]`	`list`	Valori di ogni campo di tipo di dati per il punto dati. È previsto che ogni valore corrispondente a un campo di tipo di dati si verifichi nello stesso ordine con cui il campo è elencato nel tipo di dati specificato in un'origine dati. Verrà compilato solo uno dei campi con numeri interi e con virgola mobile, a seconda del valore di enum del formato nel campo del tipo dell'origine dati.
`point[].value[].fpVal`	`double`	Valore con virgola mobile. Se questa opzione è impostata, non è necessario impostare altri valori.
`point[].value[].intVal`	`integer`	Valore intero. Se questa opzione è impostata, non è necessario impostare altri valori.
`point[].value[].mapVal[]`	`list`	Valore mappa. Lo spazio della chiave e le unità valide per il valore corrispondente di ogni voce devono essere documentati come parte della definizione del tipo di dati. Se possibile, le chiavi devono essere di dimensioni ridotte. Gli stream di dati con chiavi grandi e una frequenza di dati elevata potrebbero non essere campionati.
`point[].value[].mapVal[].key`	`string`
`point[].value[].mapVal[].value`	`nested object`
`point[].value[].mapVal[].value.fpVal`	`double`	Valore con virgola mobile.
`point[].value[].stringVal`	`string`	Valore stringa. Se questa opzione è impostata, non è necessario impostare altri valori. Se possibile, le stringhe devono essere di dimensioni ridotte. Gli stream di dati con valori stringa elevati e una frequenza dei dati elevata potrebbero non essere campionati.

Metodi

elimina: Esegue un'eliminazione inclusiva di tutti i punti dati le cui ore di inizio e di fine presentano una sovrapposizione con l'intervallo di tempo specificato dall'ID del set di dati. Per la maggior parte dei tipi di dati, l'intero punto dati verrà eliminato. Per i tipi di dati in cui l'intervallo di tempo rappresenta un valore coerente (come com.google.activity.segment) e un punto dati si trova a cavallo di uno dei punti finali del set di dati, verrà eliminata solo la parte sovrapposta del punto dati.
recupero: Restituisci un set di dati contenente tutti i punti dati le cui ore di inizio e di fine si sovrappongono all'intervallo specificato di ora di inizio minima e ora di fine massima del set di dati. In particolare, qualsiasi punto dati la cui ora di inizio è inferiore o uguale all'ora di fine del set di dati e la cui ora di fine è maggiore o uguale all'ora di inizio del set di dati.
cerotto: Aggiunge punti dati a un set di dati. Non è necessario creare il set di dati in precedenza. Tutti i punti all'interno del set di dati specificato verranno restituiti con le chiamate successive per recuperare questo set di dati. I punti dati possono appartenere a più di un set di dati.

Questo metodo non utilizza la semantica delle patch: i punti dati forniti sono semplicemente inseriti, senza la sostituzione dei dati esistenti.