Users.sessions: update

Belirli bir oturumu günceller veya ekler. Şimdi deneyin.

İstek

HTTP isteği

PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
sessionId string Oluşturulacak oturumun kimliği.
userId string Tanımlanan kişi için oturumlar oluşturun. Belirtmek için me kullanın kimlik doğrulaması yapılmış olmalıdır. Şu anda yalnızca me desteklenmektedir.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:

Kapsam
https://www.googleapis.com/auth/fitness.activity.write

Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atın.

İstek içeriği

İstek gövdesinde, verileri aşağıdaki yapıyla sağlayın:

{
  "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
}
Mülk adı Değer Açıklama Notlar
id string Söz konusu kullanıcının sahip olduğu tüm oturumlarda, istemci tarafından oluşturulan benzersiz tanımlayıcı.
name string Oturumun kullanıcılar tarafından okunabilen adı.
description string Bu oturumla ilgili açıklama.
startTimeMillis long Dönemden bu yana geçen milisaniye cinsinden başlangıç zamanı (bu değerler dahil).
endTimeMillis long Dönemden bu yana geçen milisaniye cinsinden bitiş zamanı (bu değerler dahil).
modifiedTimeMillis long Oturumun en son ne zaman değiştirildiğini gösteren bir zaman damgası.
application nested object Oturumu oluşturan uygulama.
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.
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.
application.detailsUrl string Tekrar uygulamaya bağlantı vermek için kullanılabilecek isteğe bağlı bir URI.
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.
activityType integer Bu oturumun temsil ettiği etkinlik türü.
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.

Yanıt

Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
  "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
}
Mülk adı Değer Açıklama Notlar
id string Söz konusu kullanıcının sahip olduğu tüm oturumlarda, istemci tarafından oluşturulan benzersiz tanımlayıcı.
name string Oturumun kullanıcılar tarafından okunabilen adı.
description string Bu oturumla ilgili açıklama.
startTimeMillis long Dönemden bu yana geçen milisaniye cinsinden başlangıç zamanı (bu değerler dahil).
endTimeMillis long Dönemden bu yana geçen milisaniye cinsinden bitiş zamanı (bu değerler dahil).
modifiedTimeMillis long Oturumun en son ne zaman değiştirildiğini gösteren bir zaman damgası.
application nested object Oturumu oluşturan uygulama.
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.
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.
application.detailsUrl string Tekrar uygulamaya bağlantı vermek için kullanılabilecek isteğe bağlı bir URI.
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.
activityType integer Bu oturumun temsil ettiği etkinlik türü.
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.

Deneyin!

Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.