Users.sessions: list

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 değerler 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 değerler 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.