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.

Sessioni

Le sessioni consentono agli utenti di visualizzare in modo facile e veloce un elenco di tutte le principali attività svolte. Vengono visualizzati nella pagina del diario dell'app Google Fit. Per ad esempio una sessione di respirazione, una camminata, una corsa o una notte esempi di una sessione.

Le sessioni raggruppano i set di dati relativi a un periodo di tempo specifico, raccolti durante un'attività. Ad esempio, se un utente ha monitorato quando ha iniziato e terminato un percorso di 3 km corsa, è possibile creare una sessione e tutti i dati relativi all'attività fisica contenuti in quel lasso di tempo (come passi, velocità, distanza) viene associato a quella sessione.

Le sessioni in sé non contengono dettagli sull'attività. Questo è il del set di dati. Le sessioni hanno le seguenti proprietà:

Un nome descrittivo e descrittivo (ad esempio "corsa mattutina")
Una descrizione
Un identificatore univoco
Il tipo di attività che sta acquisendo (ad esempio una corsa)

Vantaggi dell'utilizzo delle sessioni

Utili per gli utenti: le sessioni consentono di organizzare i dati relativi all'attività e gli esercizi in un un modo significativo per gli utenti. Possono vedere tutte le attività svolte per la giornata in Pagina del diario nell'app Google Fit.
Esperienza utente coerente: se l'app o il dispositivo companion consente attività. il monitoraggio (dove gli utenti possono iniziare e interrompere un'attività), con sessioni per questi esercizi consentono agli utenti di vedere la propria attività in entrambe le app.
Dati più completi: Google Fit unisce anche i dati di più per integrare e arricchire le informazioni sulle sessioni. Questo offre agli utenti un quadro più completo delle loro attività.
Sfruttare la piattaforma Google Fit: se gli utenti non monitorano la loro attività oppure la tua app non supporta il monitoraggio, puoi comunque leggere le sessioni in Google Fit. Puoi eseguire query su dati dettagliati o aggregati dal negozio per il fitness e trovare disponibili senza dover implementare uno schema personalizzato archiviazione.
Maggiore coinvolgimento degli utenti: puoi mostrare agli utenti le sessioni disponibili e il le app che li hanno creati. L'interazione con altre app per l'attività fisica potrebbe aumentare il coinvolgimento degli utenti.

Ottenere l'autorizzazione degli utenti per le sessioni

Se vuoi leggere o scrivere sessioni, la tua app deve ottenere i dati autorizzazione. L'accesso alle sessioni utilizza gli stessi ambiti di autorizzazione come tipi di dati, che dovresti richiedere come segue:

Android

Specifica il tipo di sessione a cui deve accedere la tua app, usando l'app da FitnessOptions. Ad esempio, per leggere le sessioni relative alla corsa, potresti scegliere:

    val fitnessOptions = FitnessOptions.builder()
        .accessActivitySessions(FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
        .addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
        .build()

Questo esempio specifica che la tua app vuole accedere ai metadati della sessione di attività. e specifica anche i tipi di dati che vuole leggere all'interno di quelle sessioni; il In questo esempio vengono usati i tipi di dati relativi a battito cardiaco, velocità e posizione.

REST

Ambiti delle richieste come segue:

Sessioni con tipi di attività del sonno:
- https://www.googleapis.com/auth/fitness.sleep.read
- https://www.googleapis.com/auth/fitness.sleep.write
Tutte le altre sessioni:
- https://www.googleapis.com/auth/fitness.activity.read
- https://www.googleapis.com/auth/fitness.activity.write

Utilizzo delle sessioni

Android

Puoi utilizzare l'API Sessions per:

Crea sessioni in tempo reale
Inserisci sessioni nel fitness store
Inserisci segmenti di attività per supportare le pause durante gli esercizi
Legge le sessioni e i set di dati associati
Avvia un'altra app per mostrare informazioni su una sessione creata
Ricevere un intent quando un'altra app avvia una sessione

REST

Puoi utilizzare l'API Sessions per:

Crea sessioni in tempo reale
Inserisci sessioni nel fitness store
Inserisci segmenti di attività per supportare le pause durante gli esercizi
Legge le sessioni e i set di dati associati

In che modo i set di dati e i segmenti interagiscono con le sessioni

In Google Fit:

Un set di dati rappresenta un insieme di punti dati da un determinato origine dati per un periodo di tempo specifico. I set di dati possono essere inseriti personali. Tuttavia, se intendi creare una sessione, potrebbe essere più semplice creare e i relativi set di dati.
Un segmento raggruppa i set di dati in una sessione in base all'attività esatta dell'utente. durante la sessione. Ad esempio, se l'utente monitora una corsa di 30 minuti (il sessione) ma durante questo periodo di tempo abbiamo camminato per un po', la situazione potrebbe essere suddivisa segmenti. Ci sarebbe un segmento per la corsa, poi la pausa camminata e infine la esegui di nuovo.

di Gemini Advanced.

**Figura 1**: app diverse aggiungono sessioni e set di dati a [fitness store].

La figura 1 mostra un intervallo di tempo nel negozio per il fitness durante il quale sono state inserite le app A, B e C alcuni set di dati e sessioni:

L'app A ha inserito i set di dati A1 e A2 insieme alle sessioni 1 e A3 indipendentemente dalle sessioni.
L'app B ha inserito i set di dati B1 e B2 insieme alla Sessione 2.
L'app C ha inserito il set di dati C1 indipendentemente da qualsiasi sessione.

Durante la lettura dei dati di sessione dal fitness store, tutti i dati relativi all'attività fisica che rientrano nell'intervallo di tempo di una sessione viene automaticamente associata sessione, anche se inserisci i dati dopo aver creato la sessione o crei una successiva al monitoraggio passivo dei dati. Ad esempio, una query per l'attività fisica i dati della Sessione 1 restituiranno:

Set di dati A1
Set di dati A2
La parte del set di dati A3 tra t1 e t2
La parte del set di dati C1 tra t1 e t2

Puoi capire quale app ha inserito ogni sessione e set di dati.

Creazione di sessioni

Le sessioni possono essere create in diversi modi:

La tua app può creare attivamente una sessione in
- In tempo reale quando un utente monitora attivamente un'attività su un dispositivo (solo Android) oppure
- inserendolo manualmente.
Quando un utente aggiunge manualmente un esercizio o un'attività nell'app Google Fit.

Quando creare una sessione

Stai aggiungendo dati relativi al sonno?

Sì: crea una sessione e inseriscila manualmente nel Fitness Store. Ad esempio, inserendo una sessione di sonno. Questo è che gli utenti che hanno app o dispositivi per il monitoraggio del sonno non interagiscono con i dispositivi. per avviare e interrompere l'attività del sonno (ciò viene monitorato passivamente).
No. L'app consente agli utenti di avviare e interrompere attività?
- No. Non creare una sessione. Aggiungi solo set di dati dalla tua app.
- Sì: con l'API Android, puoi creare una sessione in tempo reale se gli utenti monitorano la propria attività o manualmente. Con l'API REST, crea una sessione e inseriscila manualmente nel Fitness Store.
- La tua app può rilevare quando un utente sta svolgendo diverse attività su un livello dettagliato (ad es. camminata rispetto a corsa)?
  - Sì: aggiungi segmenti.
  - No: aggiungi solo set di dati. Ignora segmenti e lasciare che sia Google Fit a crearli passivamente.

Sessioni di lettura

La tua app può leggere le sessioni in diversi modi:

Cerca una sessione specifica creata/inserita da
- Nome o
- ID
Cerca tutte le sessioni che ha creato/inserito, per periodo di tempo
Cerca tutte le sessioni disponibili create da tutte le app (incluso Google Fit) in base al periodo di tempo

Scopri quali origini hanno creato una sessione

Puoi mostrare agli utenti quale app o dispositivo ha creato ciascuna delle loro sessioni. Ciascuna a una sessione è associata a un'origine dati, che contiene informazioni sull'app dispositivo che ha raccolto o trasformato i dati.

Android

Al momento puoi ottenere solo il nome pacchetto di una sessione scritta da un di alto profilo. Per ottenere il nome del pacchetto dell'app che ha creato una sessione, utilizza la getAppPackageName. Puoi usare queste informazioni nella tua app per mostrare utenti che altre app hanno inserito sessioni di fitness. Puoi mostrare l'icona per ognuno di questi app per aiutare gli utenti a identificarle.

Puoi anche attivare intent a avviare altre app per visualizzare i dettagli delle sessioni create. Anche altre app possono attivare un intent per lanciare l'app.

Scopri di più su come trovare l'origine che ha creato un sessione.

REST

Per ottenere il nome del pacchetto dell'app per Android che ha creato le sessioni, utilizza il metodo Proprietà session.application. Per le sessioni create utilizzando API REST, usa la proprietà session.name. Puoi utilizzare questo Informazioni nella tua app per mostrare agli utenti quali altre app hanno inserito informazioni sull'attività fisica sessioni. Puoi mostrare l'icona di ciascuna di queste app per aiutare gli utenti a identificare che li rappresentano.

Scopri di più su come trovare l'origine che ha creato un sessione.