Users.sessions: update

Güncellemeler veya belirli bir oturum ekleme. Ş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. Kimliği doğrulanmış kullanıcıyı belirtmek için me kullanın. Ş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 için kimlik doğrulama ve yetkilendirme sayfasına bakı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 Müşteri tarafından oluşturulan ve bu kullanıcının sahip olduğu tüm oturumlarda benzersiz bir tanımlayıcı.
name string Oturumun kullanıcılar tarafından okunabilir adı.
description string Bu oturumun açıklaması.
startTimeMillis long Dönemden bu yana geçen milisaniye cinsinden başlangıç zamanı (bu tarih dahil).
endTimeMillis long Dönemden itibaren milisaniye cinsinden bitiş zamanı (epoch (epoch) dahil).
modifiedTimeMillis long Oturumun en son ne zaman değiştirildiğini belirten bir zaman damgası.
application nested object Oturumu oluşturan uygulama.
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.
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.
application.detailsUrl string Uygulamaya geri bağlantı oluşturmak 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ı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.
activityType integer Bu oturumun temsil ettiği aktivite türü.
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.

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 Müşteri tarafından oluşturulan ve bu kullanıcının sahip olduğu tüm oturumlarda benzersiz bir tanımlayıcı.
name string Oturumun kullanıcılar tarafından okunabilir adı.
description string Bu oturumun açıklaması.
startTimeMillis long Dönemden bu yana geçen milisaniye cinsinden başlangıç zamanı (bu tarih dahil).
endTimeMillis long Dönemden itibaren milisaniye cinsinden bitiş zamanı (epoch (epoch) dahil).
modifiedTimeMillis long Oturumun en son ne zaman değiştirildiğini belirten bir zaman damgası.
application nested object Oturumu oluşturan uygulama.
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.
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.
application.detailsUrl string Uygulamaya geri bağlantı oluşturmak 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ı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.
activityType integer Bu oturumun temsil ettiği aktivite türü.
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.

Deneyin.

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