Users.dataSources.dataPointChanges: list

Le query relative alle modifiche del punto dati dell'utente per una determinata origine dati. Prova subito.

Richiesta

Richiesta HTTP

GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/dataPointChanges

Parametri

Nome del parametro Valore Descrizione
Parametri percorso
dataSourceId string L'ID stream di dati dell'origine dati che ha creato il set di dati.
userId string Elenca i punti dati per la persona identificata. Usa me per indicare l'utente autenticato. Al momento è supportato solo me.
Parametri di query facoltativi
limit integer Se specificato, non verranno incluse più modifiche dei punti dati nella risposta.
pageToken string Il token di continuazione, utilizzato per scorrere set di risultati di grandi dimensioni. Per visualizzare la pagina dei risultati successiva, imposta questo parametro sul valore nextPageToken dalla risposta precedente.

Autorizzazione

Questa richiesta richiede l'autorizzazione con almeno uno dei seguenti ambiti:

Ambito
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "insertedDataPoint": [
    {
      "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
    }
  ],
  "deletedDataPoint": [
    {
      "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,
  "dataSourceId": string
}
Nome proprietà Valore Descrizione Note
insertedDataPoint[] list Punti dati inseriti per l'utente.
insertedDataPoint[].startTimeNanos long L'ora di inizio dell'intervallo rappresentato da questo punto dati, in nanosecondi dall'epoca.
insertedDataPoint[].endTimeNanos long L'ora di fine dell'intervallo rappresentato da questo punto dati, in nanosecondi dall'epoca.
insertedDataPoint[].dataTypeName string Il tipo di dati che definisce il formato dei valori in questo punto dati.
insertedDataPoint[].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.
insertedDataPoint[].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.

insertedDataPoint[].value[].intVal integer Valore intero. Se questa impostazione è impostata, non è necessario impostare altri valori.
insertedDataPoint[].value[].fpVal double Valore con virgola mobile. Se questa impostazione è impostata, non è necessario impostare altri valori.
insertedDataPoint[].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.
insertedDataPoint[].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.
insertedDataPoint[].value[].mapVal[].key string
insertedDataPoint[].value[].mapVal[].value nested object
insertedDataPoint[].value[].mapVal[].value.fpVal double Valore con virgola mobile.
insertedDataPoint[].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.
insertedDataPoint[].rawTimestampNanos long Il timestamp non elaborato del SensorEvent originale.
insertedDataPoint[].computationTimeMillis long NON UTILIZZARE QUESTO CAMPO. ma viene ignorato e non archiviato.
deletedDataPoint[] list Punti dati dell'utente eliminati. Nota: per le modifiche, questo deve essere analizzato prima di gestire gli inserimenti.
deletedDataPoint[].startTimeNanos long L'ora di inizio dell'intervallo rappresentato da questo punto dati, in nanosecondi dall'epoca.
deletedDataPoint[].endTimeNanos long L'ora di fine dell'intervallo rappresentato da questo punto dati, in nanosecondi dall'epoca.
deletedDataPoint[].dataTypeName string Il tipo di dati che definisce il formato dei valori in questo punto dati.
deletedDataPoint[].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.
deletedDataPoint[].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.

deletedDataPoint[].value[].intVal integer Valore intero. Se questa impostazione è impostata, non è necessario impostare altri valori.
deletedDataPoint[].value[].fpVal double Valore con virgola mobile. Se questa impostazione è impostata, non è necessario impostare altri valori.
deletedDataPoint[].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.
deletedDataPoint[].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.
deletedDataPoint[].value[].mapVal[].key string
deletedDataPoint[].value[].mapVal[].value nested object
deletedDataPoint[].value[].mapVal[].value.fpVal double Valore con virgola mobile.
deletedDataPoint[].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.
deletedDataPoint[].rawTimestampNanos long Il timestamp non elaborato del SensorEvent originale.
deletedDataPoint[].computationTimeMillis long NON UTILIZZARE QUESTO CAMPO. ma viene ignorato e non archiviato.
nextPageToken string Il token di continuazione, utilizzato per scorrere set di risultati di grandi dimensioni. Fornisci questo valore in una richiesta successiva per restituire la pagina dei risultati successiva.
dataSourceId string L'ID stream di dati dell'origine dati con modifiche ai punti dati.

Prova

Usa Explorer API in basso per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.