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 |
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ülmelidir. |
endTime |
string |
RFC3339 zaman damgası. Yalnızca başlangıç ve bitiş zamanları arasında biten oturumlar yanıta dahil edilir. Bu süre atlanır ancak startTime belirtilirse startTime ile bitiş tarihi arasındaki tüm oturumlar döndürülür. |
includeDeleted |
boolean |
Doğruysa 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 etme jetonu.
Sonraki değişiklik grubunu almak için bu parametreyi önceki yanıttan 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 biten oturumlar yanıta dahil edilir. Bu süre atlanır ancak endTime belirtilirse en başı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 gereklidir:
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ını inceleyin.
İstek metni
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 olan oturumlar. |
|
session[].id |
string |
Bu kullanıcının sahip olduğu tüm oturumlarda benzersiz olan, istemci tarafından oluşturulan bir tanımlayıcı. | |
session[].name |
string |
Oturumun kullanıcılar tarafından okunabilen adı. | |
session[].description |
string |
Bu oturumun açıklaması. | |
session[].startTimeMillis |
long |
Dönemden bu yana, milisaniye cinsinden bir başlangıç zamanı. | |
session[].endTimeMillis |
long |
Dönemden bu yana, milisaniye cinsinden bir bitiş zamanı. | |
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 uygulamanın paket adı. Bu kimlik, Android uygulamaları tarafından benzersiz bir tanımlayıcı olarak kullanılır ancak REST istemcileri tarafından belirtilemez. REST istemcileri, packageName yerine Veri Kaynağı veri akışı kimliklerine geliştirici proje numarasını yansıtacaktır. | |
session[].application.version |
string |
Uygulamanın sürümü. Uygulama, verilerin hesaplanmasını etkileyecek şekilde değiştiğinde bu alanı güncellemeniz gerekir. | |
session[].application.detailsUrl |
string |
Uygulamaya yeniden bağlanmak 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 benzersizliğini zorunlu kılmayız. Hangi REST'in Uygulama veya Veri Kaynağı oluşturduğunu belirlemek isteyen diğer geliştiricilere kolaylık sağlamak amacıyla sunulmaktadır. | |
session[].activityType |
integer |
Bu oturumun temsil ettiği etkinlik türü. | |
deletedSession[] |
list |
includeDeleted , istekte true olarak ayarlanırsa ve startTime ile endTime atlanırsa son senkronizasyondan beri silinen oturumlar da bu kapsama girer. |
|
deletedSession[].id |
string |
Bu kullanıcının sahip olduğu tüm oturumlarda benzersiz olan, istemci tarafından oluşturulan bir tanımlayıcı. | |
deletedSession[].name |
string |
Oturumun kullanıcılar tarafından okunabilen adı. | |
deletedSession[].description |
string |
Bu oturumun açıklaması. | |
deletedSession[].startTimeMillis |
long |
Dönemden bu yana, milisaniye cinsinden bir başlangıç zamanı. | |
deletedSession[].endTimeMillis |
long |
Dönemden bu yana, milisaniye cinsinden bir bitiş zamanı. | |
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 uygulamanın paket adı. Bu kimlik, Android uygulamaları tarafından benzersiz bir tanımlayıcı olarak kullanılır ancak REST istemcileri tarafından belirtilemez. REST istemcileri, packageName yerine Veri Kaynağı veri akışı kimliklerine geliştirici proje numarasını yansıtacaktır. | |
deletedSession[].application.version |
string |
Uygulamanın sürümü. Uygulama, verilerin hesaplanmasını etkileyecek şekilde değiştiğinde bu alanı güncellemeniz gerekir. | |
deletedSession[].application.detailsUrl |
string |
Uygulamaya yeniden bağlanmak 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 benzersizliğini zorunlu kılmayız. Hangi REST'in Uygulama veya Veri Kaynağı oluşturduğunu belirlemek isteyen diğer geliştiricilere kolaylık sağlamak amacıyla sunulmaktadı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, yalnızca startTime ve endTime istekten çıkarılırsa sağlanacaktır. | |
session[].activeTimeMillis |
long |
Oturumun etkin olduğu zaman. start_time_millis ve end_time_millis tüm oturum zamanını tanımlarken etkin süre daha kısa olabilir ve Active_time_millis tarafından belirtilebilir. Oturum sırasında etkin olmayan zaman biliniyorsa SMALL etkinlik değeri ile bir com.google.activity.segment veri noktası da eklenmelidir |
|
deletedSession[].activeTimeMillis |
long |
Oturumun etkin olduğu zaman. start_time_millis ve end_time_millis tüm oturum zamanını tanımlarken etkin süre daha kısa olabilir ve Active_time_millis tarafından belirtilebilir. Oturum sırasında etkin olmayan zaman biliniyorsa SMALL etkinlik değeri ile bir com.google.activity.segment veri noktası da eklenmelidir |
|
hasMoreData |
boolean |
Sunucunun aktarılacak daha fazla verisi olduğunu belirtmek için işaretleyin. BU ALANI KULLANMAYIN. 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.