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

Definizione di una fonte unica di dati dei sensori. Le origini dati possono esporre dati non elaborati provenienti da sensori hardware su dispositivi locali o associati. Possono anche esporre dati derivati, creati trasformando o unendo altre origini dati. Possono esistere più origini dati per lo stesso tipo di dati. A ogni punto dati inserito o letto da questo servizio è associata un'origine dati.

L'origine dati contiene informazioni sufficienti a identificare in modo univoco i suoi dati, inclusi il dispositivo hardware e l'applicazione che ha raccolto e/o trasformato i dati. Contiene anche metadati utili, come le versioni hardware e dell'applicazione e il tipo di dispositivo.

Ogni origine dati produce un flusso di dati univoco, con un identificatore univoco. Non tutte le modifiche all'origine dati influiscono sull'identificatore dello stream, pertanto i dati raccolti dalle versioni aggiornate della stessa applicazione o dello stesso dispositivo possono comunque essere considerati appartenenti allo stesso stream di dati.

Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.

Rappresentazioni delle risorse

{
  "dataStreamId": string,
  "name": string,
  "dataStreamName": string,
  "type": string,
  "dataType": {
    "name": string,
    "field": [
      {
        "name": string,
        "format": string,
        "optional": boolean
      }
    ]
  },
  "device": {
    "uid": string,
    "type": string,
    "version": string,
    "model": string,
    "manufacturer": string
  },
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "dataQualityStandard": [
    string
  ]
}

Nome proprietà	Valore	Descrizione
`application`	`nested object`	Informazioni su un'applicazione che alimenta i dati dei sensori nella piattaforma.
`application.detailsUrl`	`string`	Un URI facoltativo che può essere utilizzato per rimandare all'applicazione.
`application.name`	`string`	Il nome di questa applicazione. Questa operazione è obbligatoria per i client REST, ma non applichiamo l'univocità di questo nome. Viene fornito per comodità ad altri sviluppatori che vorrebbero identificare il REST che ha creato un'applicazione o un'origine dati.
`application.packageName`	`string`	Nome del pacchetto per questa applicazione. Viene utilizzato come identificatore univoco quando viene creato dalle app per Android, ma non può essere specificato dai client REST. Per i client REST, il numero del progetto sviluppatore sarà riportato negli ID stream di dati dell'origine dati, invece che nel valore packageName.
`application.version`	`string`	Versione dell'applicazione. Devi aggiornare questo campo ogni volta che l'applicazione cambia in modo da influire sul calcolo dei dati.
`dataQualityStandard[]`	`list`	NON POPOLARE QUESTO CAMPO. Non viene mai inserito nelle risposte dalla piattaforma e viene ignorato nelle query. Verrà rimossa completamente in una versione futura.
`dataStreamId`	`string`	Un identificatore univoco per lo stream di dati prodotto da questa origine dati. L'identificatore include: Il produttore, il modello e il numero di serie (UID) del dispositivo fisico. Il nome o il nome del pacchetto dell'applicazione. Il nome del pacchetto viene utilizzato quando l'origine dati è stata creata da un'applicazione Android. Il numero del progetto sviluppatore viene utilizzato quando l'origine dati è stata creata da un client REST. Il tipo di origine dati. Il nome dello stream dell'origine dati. Tieni presente che non tutti gli attributi dell'origine dati vengono utilizzati come parte dell'identificatore stream. Nello specifico, non viene utilizzata la versione dell'hardware o dell'applicazione. In questo modo possiamo mantenere lo stesso flusso tramite gli aggiornamenti della versione. Ciò significa anche che due oggetti DataSource potrebbero rappresentare lo stesso stream di dati anche se non sono uguali. Il formato esatto dell'ID stream di dati creato da un'applicazione Android è: `type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName` Il formato esatto dell'ID stream di dati creato da un client REST è: `type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName` Se uno qualsiasi dei campi facoltativi che compongono l'ID stream di dati non è presente, verrà omesso dall'ID stream di dati. L'ID minimo dello stream di dati utilizzabile sarebbe: type:dataType.name:developer project number Infine, il numero del progetto sviluppatore e l'UID del dispositivo vengono offuscati quando vengono letti da un client REST o Android che non ha creato l'origine dati. Solo il creatore dell'origine dati vedrà il numero del progetto dello sviluppatore in formato normale e chiaro. Ciò significa che un client vedrà un set di data_stream_id diverso rispetto a un altro client con credenziali differenti.
`dataStreamName`	`string`	Il nome del flusso identifica in modo univoco questa particolare origine dati tra altre origini dati dello stesso tipo provenienti dallo stesso producer sottostante. L'impostazione del nome dello stream è facoltativa, ma dovrebbe essere eseguita ogni volta che un'applicazione espone due stream per lo stesso tipo di dati o quando un dispositivo ha due sensori equivalenti.
`dataType`	`nested object`	Il tipo di dati definisce lo schema di un flusso di dati che vengono raccolti, inseriti o sottoposti a query dall'API Fitness.
`dataType.field[]`	`list`	Un campo rappresenta una dimensione di un tipo di dati.
`dataType.field[].format`	`string`	I diversi formati supportati per ogni campo di un tipo di dati. I valori accettati sono: "`blob`" "`floatList`" "`floatPoint`" "`integer`" "`integerList`" "`map`" "`string`"
`dataType.field[].name`	`string`	Definisce il nome e il formato dei dati. A differenza dei nomi dei tipi di dati, i nomi dei campi non hanno uno spazio dei nomi e devono essere univoci solo all'interno del tipo di dati.
`dataType.field[].optional`	`boolean`
`dataType.name`	`string`	Ogni tipo di dati ha un nome univoco con spazio dei nomi. Tutti i tipi di dati nello spazio dei nomi com.google vengono condivisi come parte della piattaforma.
`device`	`nested object`	Rappresentazione di un dispositivo integrato (ad esempio uno smartphone o un dispositivo indossabile) in grado di contenere sensori.
`device.manufacturer`	`string`	Produttore del prodotto/hardware.
`device.model`	`string`	Nome di modello visibile all'utente finale del dispositivo.
`device.type`	`string`	Una costante che rappresenta il tipo di dispositivo. I valori accettati sono: "`chestStrap`" "`headMounted`" "`phone`" "`scale`" "`smartDisplay`" "`tablet`" "`unknown`" "`watch`"
`device.uid`	`string`	Il numero di serie o un altro ID univoco dell'hardware. Questo campo è offuscato quando viene letto da qualsiasi client REST o Android che non ha creato l'origine dati. Solo l'autore dell'origine dati vedrà il campo UID in formato normale e chiaro. L'offuscamento preserva l'uguaglianza; cioè, dati due ID, se id1 == id2, offuscato(id1) == offuscato(id2).
`device.version`	`string`	Stringa della versione per l'hardware/software del dispositivo.
`name`	`string`	Un nome visibile all'utente finale per questa origine dati.
`type`	`string`	Una costante che descrive il tipo di questa origine dati. Indica se questa origine dati produce dati non elaborati o derivati. I valori accettati sono: "`derived`" "`raw`"

Metodi

creazione: Crea una nuova origine dati univoca per tutte le origini dati appartenenti a questo utente.

Un'origine dati è una fonte unica di dati dei sensori. Le origini dati possono esporre Dati non elaborati provenienti da sensori hardware su dispositivi locali o associati. Loro può anche esporre dati derivati, creati trasformando o unendo altri dati fonti. Possono esistere più origini dati per lo stesso tipo di dati. Ogni dato punto in ogni set di dati inserito o letto dall'API Fitness ha un un'origine dati associata.

Ogni origine dati produce un flusso univoco di aggiornamenti del set di dati, con un identificatore univoco dell'origine dati. Non tutte le modifiche all'origine dati influiscono sul l'ID stream di dati, in modo che i dati raccolti dalle versioni aggiornate l'applicazione/il dispositivo possono essere considerati appartenenti agli stessi dati sorgente.

Le origini dati vengono identificate utilizzando una stringa generata dal server, in base sui contenuti dell'origine che viene creata. dataStreamId non deve essere impostato quando richiami questo metodo. it verranno generati automaticamente dal server con il formato corretto. Se un dataStreamId è impostato, deve corrispondere al formato utilizzato generato dal server. Questo formato è una combinazione di alcuni campi dell'origine dati e ha un ordine specifico. Se non corrisponde, la richiesta non riuscirà con un errore.

Specificare un DataType che non è un tipo noto (a partire da "com.google.") creerà un'origine dati con un tipo di dati personalizzato. I tipi di dati personalizzati sono leggibili solo dall'applicazione che li ha creati. I tipi di dati personalizzati sono ritirati, utilizza tipi di dati standard .

Oltre ai campi dell'origine dati inclusi nell'ID origine dati, il valore numero del progetto sviluppatore autenticato durante la creazione dei dati è inclusa l'origine dati. Questo numero di progetto sviluppatore è offuscato durante la lettura da parte di qualsiasi altro sviluppatore che legge i tipi di dati pubblici.
elimina: Elimina l'origine dati specificata. La richiesta avrà esito negativo se i dati l'origine contiene qualsiasi punto dati.
trova: Restituisci l'origine dati specificata.
list: Elenca tutte le origini dati visibili allo sviluppatore, utilizzando il protocollo OAuth gli ambiti forniti. L'elenco non è completo; l'utente potrebbe avere delle informazioni origini dati visibili soltanto ad altri sviluppatori oppure chiamate tramite altri ambiti.
aggiorna: Aggiorna l'origine dati specificata. dataStreamId, dataType, type, dataStreamName e device proprietà ad eccezione di version, non può essere modificato.

Le origini dati sono identificate dal relativo dataStreamId.