Daha önce 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 |
Belirlenen kişinin oturumlarını listeleyin. Belirtmek için me kullanın
kimlik doğrulaması yapılmış olmalıdır. Ş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ülmelidir. |
endTime |
string |
RFC3339 zaman damgası. Yalnızca başlangıç ve bitiş zamanları arasında sona eren oturumlar dahil edilir yanıt verelim. Bu saat atlanır ancak startTime değeri gösterilirse belirtilenden sonra startTime tarihinden sonuna kadar olan tüm oturumlar iade edilir. |
includeDeleted |
boolean |
Doğru ise ve hem startTime hem de endTime ise atlanırsa, oturum silme işlemleri döndürülür. |
pageToken |
string |
Artımlı senkronizasyon için kullanılan devamlılık jetonu.
Bir sonraki değişiklik grubunu almak için bu parametreyi
Önceki yanıtta verilen yanıt: nextPageToken . Sayfa jetonu
başlangıç veya bitiş zamanı belirtilirse yoksayılır. Başlangıç zamanı yoksa
ve sayfa jetonu belirtildiğinde, son
30 gün iade edilir.
|
startTime |
string |
RFC3339 zaman damgası. Yalnızca başlangıç ve bitiş zamanları arasında sona eren oturumlar dahil edilir yanıt verelim. Bu saat atlanır ancak endTime belirtilirse başlangıcından endTime tarihine kadar olan tüm oturumlar olacak geri döndü. |
Yetkilendirme
Bu istek, aşağıdaki kapsamların en az biriyle yetkilendirme gerektiriyor:
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 edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atın.
İstek içeriği
Bu yöntemle 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 olan oturumlar. |
|
session[].id |
string |
Söz konusu kullanıcının sahip olduğu tüm oturumlarda, istemci tarafından oluşturulan benzersiz tanımlayıcı. | |
session[].name |
string |
Oturumun kullanıcılar tarafından okunabilen adı. | |
session[].description |
string |
Bu oturumla ilgili açıklama. | |
session[].startTimeMillis |
long |
Dönemden bu yana geçen milisaniye cinsinden başlangıç zamanı (bu değerler dahil). | |
session[].endTimeMillis |
long |
Dönemden bu yana geçen milisaniye cinsinden bitiş zamanı (bu süreler dahil). | |
session[].modifiedTimeMillis |
long |
Oturumun en son ne zaman değiştirildiğini gösteren bir zaman damgası. | |
session[].application |
nested object |
Oturumu oluşturan uygulama. | |
session[].application.packageName |
string |
Bu uygulamanın paket adı. Bu ad, Android uygulamaları tarafından oluşturulduğunda benzersiz bir tanımlayıcı olarak kullanılır ancak REST istemcileri tarafından belirtilemez. REST istemcilerinin geliştirici proje numaraları, packageName yerine Veri Kaynağı veri akışı kimliklerine yansıtılır. | |
session[].application.version |
string |
Uygulamanın sürümü. Uygulama, verilerin hesaplamasını etkileyecek şekilde her değişiklik yaptığında bu alanı güncellemeniz gerekir. | |
session[].application.detailsUrl |
string |
Tekrar uygulamaya bağlantı vermek 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ı zorunlu değildir. Bu bilgi, 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 etkinlik türü. | |
deletedSession[] |
list |
includeDeleted , istekte doğru değerine ayarlanırsa ve startTime ile endTime atlanırsa son senkronizasyondan sonra silinen oturumlar da dahil edilir. |
|
deletedSession[].id |
string |
Söz konusu kullanıcının sahip olduğu tüm oturumlarda, istemci tarafından oluşturulan benzersiz tanımlayıcı. | |
deletedSession[].name |
string |
Oturumun kullanıcılar tarafından okunabilen adı. | |
deletedSession[].description |
string |
Bu oturumla ilgili açıklama. | |
deletedSession[].startTimeMillis |
long |
Dönemden bu yana geçen milisaniye cinsinden başlangıç zamanı (bu değerler dahil). | |
deletedSession[].endTimeMillis |
long |
Dönemden bu yana geçen milisaniye cinsinden bitiş zamanı (bu süreler dahil). | |
deletedSession[].modifiedTimeMillis |
long |
Oturumun en son ne zaman değiştirildiğini gösteren bir zaman damgası. | |
deletedSession[].application |
nested object |
Oturumu oluşturan uygulama. | |
deletedSession[].application.packageName |
string |
Bu uygulamanın paket adı. Bu ad, Android uygulamaları tarafından oluşturulduğunda benzersiz bir tanımlayıcı olarak kullanılır ancak REST istemcileri tarafından belirtilemez. REST istemcilerinin geliştirici proje numaraları, packageName yerine Veri Kaynağı veri akışı kimliklerine yansıtılır. | |
deletedSession[].application.version |
string |
Uygulamanın sürümü. Uygulama, verilerin hesaplamasını etkileyecek şekilde her değişiklik yaptığında bu alanı güncellemeniz gerekir. | |
deletedSession[].application.detailsUrl |
string |
Tekrar uygulamaya bağlantı vermek 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ı zorunlu değildir. Bu bilgi, 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 etkinlik türü. | |
nextPageToken |
string |
Diğer değişiklikleri senkronize etmek için kullanılan senkronizasyon jetonu. Bu bilgi yalnızca istekte hem startTime hem de endTime atlanırsa sağlanır. | |
session[].activeTimeMillis |
long |
Oturumun etkin olma süresi. start_time_millis ve end_time_millis tam oturum süresini tanımlarken, aktif süre daha kısa olabilir veactive_time_millis ile belirtilebilir. Oturum sırasındaki etkin olmayan zaman biliniyorsa STILL etkinlik değerine sahip bir com.google.activity.segment veri noktası aracılığıyla da eklenmelidir. |
|
deletedSession[].activeTimeMillis |
long |
Oturumun etkin olma süresi. start_time_millis ve end_time_millis tam oturum süresini tanımlarken, aktif süre daha kısa olabilir veactive_time_millis ile belirtilebilir. Oturum sırasındaki etkin olmayan zaman 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 veri olduğunu gösteren işaret. BU ALANI KULLANMAYIN. Bu alan hiçbir zaman sunucudan gelen yanıtlarda doldurulmaz. |
Deneyin!
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.