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 registrano alcuna informazione personale. 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 di metodi per questa risorsa, vai alla 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 forse parziale del set di dati. Il tempo è in nanosecondi dall'epoca. 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. Il tempo è in nanosecondi dall'epoca. Deve corrispondere anche alla prima parte dell'identificatore del set di dati.
`nextPageToken`	`string`	Questo token verrà impostato quando viene ricevuto un set di dati in risposta a una richiesta GET e il set di dati è troppo grande per essere incluso in una singola risposta. Fornisci questo valore in una successiva richiesta GET per restituire la pagina successiva di punti dati all'interno di questo set di dati.
`point[]`	`list`	Un elenco parziale dei punti dati contenuti nel set di dati, ordinati in base a endTimeNanos. Questo elenco è considerato completo quando si recupera un set di dati di piccole dimensioni e parziale durante l'applicazione di 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. ma viene ignorato e non archiviato.
`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 nei contesti in cui vengono elencate le modifiche apportate ai dati, anziché rappresentare 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à compilato con l'ID stream dell'origine dati che ha creato originariamente il punto dati. ATTENZIONE: 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 sia coerente.
`point[].rawTimestampNanos`	`long`	Il timestamp non elaborato del 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 del tipo di dati per il punto dati. È previsto che ogni valore corrispondente a un campo di tipo dati venga generato nello stesso ordine in cui viene elencato il campo nel tipo di dati specificato in un'origine dati. Verrà compilato solo uno tra i campi con numeri interi e in virgola mobile, a seconda del valore enum del formato all'interno del campo del tipo di origine dati.
`point[].value[].fpVal`	`double`	Valore con virgola mobile. Se questa impostazione è impostata, non è necessario impostare altri valori.
`point[].value[].intVal`	`integer`	Valore intero. Se questa impostazione è impostata, non è necessario impostare altri valori.
`point[].value[].mapVal[]`	`list`	Valore mappa. Le unità e lo spazio delle chiavi validi per il valore corrispondente di ogni voce devono essere documentati come parte della definizione del tipo di dati. Le chiavi devono essere ridotte se possibile. Gli stream di dati con chiavi grandi e con una frequenza di dati elevata potrebbero essere sottoposti a campionamento inferiore.
`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 impostazione è impostata, non è necessario impostare altri valori. Le stringhe devono essere ridotte se possibile. Gli stream di dati con valori di stringa elevati e una frequenza di dati elevata potrebbero essere sottoposti a campionamento.

Metodi

elimina: Viene eseguita un'eliminazione inclusiva di tutti i punti dati le cui ore di inizio e di fine si sovrappongono all'intervallo di tempo specificato dall'ID del set di dati. Per la maggior parte tipi di dati, verrà eliminato l'intero punto dati. Per i tipi di dati in cui rappresenta un valore coerente (come com.google.activity.segment) e un punto dati è a cavallo su entrambi i punti finali del set di dati, solo la porzione sovrapposta dei dati verrà eliminato.
trova: Restituisci un set di dati contenente tutti i punti dati con ora di inizio e ora di fine si sovrappongono all'intervallo specificato dell'ora di inizio minima del set di dati l'ora di fine massima. Nello specifico, tutti i punti dati la cui ora di inizio è inferiore o uguale all'ora di fine del set di dati e la cui ora di fine è maggiore di o uguale all'ora di inizio del set di dati.
patch: Aggiunge punti dati a un set di dati. Non è necessario creare in precedenza il set di dati. Tutti i punti all'interno del set di dati specificato verranno restituiti con 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 della patch: i punti dati forniti sono è stato semplicemente inserito, senza che i dati esistenti vengano sostituiti.