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. Kimliği doğrulanmış kullanıcıyı belirtmek için me kullanın. Şu anda yalnızca me desteklenmektedir.

Yetkilendirme

Bu istek için aşağıdaki kapsamla yetkilendirme gereklidir:

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

Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasını inceleyin.

İstek metni

İstek gövdesinde, aşağıdaki yapıya sahip verileri 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 Bu kullanıcının sahip olduğu tüm oturumlarda benzersiz olan, istemci tarafından oluşturulan bir tanımlayıcı.
name string Oturumun kullanıcılar tarafından okunabilen adı.
description string Bu oturumun açıklaması.
startTimeMillis long Dönemden bu yana, milisaniye cinsinden bir başlangıç zamanı.
endTimeMillis long Dönemden bu yana, milisaniye cinsinden bir bitiş zamanı.
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 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.
application.version string Uygulamanın sürümü. Uygulama, verilerin hesaplanmasını etkileyecek şekilde değiştiğinde bu alanı güncellemeniz gerekir.
application.detailsUrl string Uygulamaya yeniden bağlanmak 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 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.
activityType integer Bu oturumun temsil ettiği etkinlik türü.
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

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 Bu kullanıcının sahip olduğu tüm oturumlarda benzersiz olan, istemci tarafından oluşturulan bir tanımlayıcı.
name string Oturumun kullanıcılar tarafından okunabilen adı.
description string Bu oturumun açıklaması.
startTimeMillis long Dönemden bu yana, milisaniye cinsinden bir başlangıç zamanı.
endTimeMillis long Dönemden bu yana, milisaniye cinsinden bir bitiş zamanı.
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 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.
application.version string Uygulamanın sürümü. Uygulama, verilerin hesaplanmasını etkileyecek şekilde değiştiğinde bu alanı güncellemeniz gerekir.
application.detailsUrl string Uygulamaya yeniden bağlanmak 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 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.
activityType integer Bu oturumun temsil ettiği etkinlik türü.
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

Deneyin.

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