Önceden oluşturulan oturumları listeler. Şimdi deneyin.
İstek
HTTP isteği
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
Parametreler
Parametre adı | Değer | Açıklama |
---|---|---|
Yol parametreleri | ||
userId |
string |
Tanımlanan kişi için oturumları listeleyin. Kimliği doğrulanmış kullanıcıyı belirtmek için me kullanın. Şu anda yalnızca me desteklenmektedir.
|
İsteğe bağlı sorgu parametreleri | ||
activityType |
integer |
Boş değilse yalnızca bu etkinlik türlerine sahip oturumlar döndürülür. |
endTime |
string |
RFC3339 zaman damgası. Yalnızca başlangıç ve bitiş zamanları arasında sona eren oturumlar yanıta dahil edilir. Bu süre atlanır ancak startTime belirtilirse startTime tarihinden zaman sonuna kadar olan tüm oturumlar döndürülür. |
includeDeleted |
boolean |
True (doğru) değerine ayarlanırsa ve hem startTime hem de endTime atlanırsa oturum silme işlemleri döndürülür. |
pageToken |
string |
Artımlı senkronizasyon için kullanılan devam jetonu.
Bir sonraki değişiklik grubunu almak için bu parametreyi önceki yanıttaki nextPageToken değerine ayarlayın. Başlangıç veya bitiş zamanı belirtilirse sayfa jetonu yoksayılır. Başlangıç zamanı, bitiş zamanı ve sayfa jetonu belirtilmezse son 30 gün içinde değiştirilen oturumlar döndürülür.
|
startTime |
string |
RFC3339 zaman damgası. Yalnızca başlangıç ve bitiş zamanları arasında sona eren oturumlar yanıta dahil edilir. Bu zaman atlanır ancak endTime belirtilirse başlangıç zamanından endTime tarihine kadar olan tüm oturumlar döndürülür. |
Yetkilendirme
Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gerekiyor:
Kapsam |
---|
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 |
Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakın.
İstek içeriği
Bu yöntemle bir istek gövdesi sağlamayın.
Yanıt
Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:
{ "session": [ { "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long } ], "deletedSession": [ { "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long } ], "nextPageToken": string, "hasMoreData": boolean }
Mülk adı | Değer | Açıklama | Notlar |
---|---|---|---|
session[] |
list |
Bitiş zamanı, isteğin startTime ile endTime arasında olduğu oturumlar. |
|
session[].id |
string |
Müşteri tarafından oluşturulan ve bu kullanıcının sahip olduğu tüm oturumlarda benzersiz bir tanımlayıcı. | |
session[].name |
string |
Oturumun kullanıcılar tarafından okunabilir adı. | |
session[].description |
string |
Bu oturumun açıklaması. | |
session[].startTimeMillis |
long |
Dönemden bu yana geçen milisaniye cinsinden başlangıç zamanı (bu tarih dahil). | |
session[].endTimeMillis |
long |
Dönemden itibaren milisaniye cinsinden bitiş zamanı (epoch (epoch) dahil). | |
session[].modifiedTimeMillis |
long |
Oturumun en son ne zaman değiştirildiğini belirten bir zaman damgası. | |
session[].application |
nested object |
Oturumu oluşturan uygulama. | |
session[].application.packageName |
string |
Bu uygulama için paket adı. Bu, Android uygulamaları tarafından oluşturulan benzersiz bir tanımlayıcı olarak kullanılır, ancak REST istemcileri tarafından belirtilemez. REST istemcilerinin geliştirici proje numarası, packageName yerine Veri Kaynağı veri akışı kimliklerine yansıtılır. | |
session[].application.version |
string |
Uygulamanın sürümü. Uygulamada verilerin hesaplamasını etkileyecek şekilde değişiklik yapıldığında bu alanı güncellemeniz gerekir. | |
session[].application.detailsUrl |
string |
Uygulamaya geri bağlantı oluşturmak için kullanılabilecek isteğe bağlı bir URI. | |
session[].application.name |
string |
Bu uygulamanın adı. Bu, REST müşterileri için gereklidir ancak bu adın benzersiz olmasını zorunlu kılmayız. Bu, hangi REST'in bir Uygulama veya Veri Kaynağı oluşturduğunu belirlemek isteyen diğer geliştiricilere kolaylık sağlamak amacıyla sağlanmıştır. | |
session[].activityType |
integer |
Bu oturumun temsil ettiği aktivite türü. | |
deletedSession[] |
list |
İstekte includeDeleted doğru değerine ayarlanırsa ve startTime ile endTime atlanırsa son senkronizasyondan sonra silinen oturumlar dahil edilir. |
|
deletedSession[].id |
string |
Müşteri tarafından oluşturulan ve bu kullanıcının sahip olduğu tüm oturumlarda benzersiz bir tanımlayıcı. | |
deletedSession[].name |
string |
Oturumun kullanıcılar tarafından okunabilir adı. | |
deletedSession[].description |
string |
Bu oturumun açıklaması. | |
deletedSession[].startTimeMillis |
long |
Dönemden bu yana geçen milisaniye cinsinden başlangıç zamanı (bu tarih dahil). | |
deletedSession[].endTimeMillis |
long |
Dönemden itibaren milisaniye cinsinden bitiş zamanı (epoch (epoch) dahil). | |
deletedSession[].modifiedTimeMillis |
long |
Oturumun en son ne zaman değiştirildiğini belirten bir zaman damgası. | |
deletedSession[].application |
nested object |
Oturumu oluşturan uygulama. | |
deletedSession[].application.packageName |
string |
Bu uygulama için paket adı. Bu, Android uygulamaları tarafından oluşturulan benzersiz bir tanımlayıcı olarak kullanılır, ancak REST istemcileri tarafından belirtilemez. REST istemcilerinin geliştirici proje numarası, packageName yerine Veri Kaynağı veri akışı kimliklerine yansıtılır. | |
deletedSession[].application.version |
string |
Uygulamanın sürümü. Uygulamada verilerin hesaplamasını etkileyecek şekilde değişiklik yapıldığında bu alanı güncellemeniz gerekir. | |
deletedSession[].application.detailsUrl |
string |
Uygulamaya geri bağlantı oluşturmak için kullanılabilecek isteğe bağlı bir URI. | |
deletedSession[].application.name |
string |
Bu uygulamanın adı. Bu, REST müşterileri için gereklidir ancak bu adın benzersiz olmasını zorunlu kılmayız. Bu, hangi REST'in bir Uygulama veya Veri Kaynağı oluşturduğunu belirlemek isteyen diğer geliştiricilere kolaylık sağlamak amacıyla sağlanmıştır. | |
deletedSession[].activityType |
integer |
Bu oturumun temsil ettiği aktivite türü. | |
nextPageToken |
string |
Diğer değişiklikleri senkronize etmek için kullanılan senkronizasyon jetonu. Bu özellik yalnızca hem startTime hem de endTime istekten çıkarıldığında sağlanır. | |
session[].activeTimeMillis |
long |
Oturumun etkin olduğu süre. start_time_millis ve end_time_millis tam oturum süresini tanımlasa da aktif süre daha kısa olabilir ve active_time_millis ile belirtilebilir. Oturum sırasında etkin olunmayan süre biliniyorsa STILL etkinlik değerine sahip bir com.google.activity.segment veri noktası aracılığıyla da eklenmelidir. |
|
deletedSession[].activeTimeMillis |
long |
Oturumun etkin olduğu süre. start_time_millis ve end_time_millis tam oturum süresini tanımlasa da aktif süre daha kısa olabilir ve active_time_millis ile belirtilebilir. Oturum sırasında etkin olunmayan süre biliniyorsa STILL etkinlik değerine sahip bir com.google.activity.segment veri noktası aracılığıyla da eklenmelidir. |
|
hasMoreData |
boolean |
Sunucunun aktarılacak daha fazla verisi olduğunu gösteren işaret. BU ALANI KULLANMAYIN. Sunucudan gelen yanıtlarda hiçbir zaman doldurulmaz. |
Deneyin.
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.