REST Resource: projects.deviceSessions

Kaynak: DeviceSession

Çeşitli RPC'lerden kullanılan, cihaz mesajını açıklayan protobuf mesajı.

JSON gösterimi 
{
  "name": string,
  "displayName": string,
  "state": enum (SessionState),
  "stateHistories": [
    {
      object (SessionStateEvent)
    }
  ],
  "inactivityTimeout": string,
  "createTime": string,
  "activeStartTime": string,
  "androidDevice": {
    object (AndroidDevice)
  },

  // Union field expiration can be only one of the following:
  "ttl": string,
  "expireTime": string
  // End of list of possible types for union field expiration.
}
Alanlar
name

string

İsteğe bağlı. DeviceSession'ın adı, ör. "projects/{projectId}/deviceSessions/{session_id}"
displayName

string

Yalnızca çıkış. Kullanıcı arayüzünde gösterilecek DeviceSession öğesinin başlığı.
state

enum (SessionState)

Yalnızca çıkış. DeviceSession'ın mevcut durumu.
stateHistories[]

object (SessionStateEvent)

Yalnızca çıkış. Mevcut oturum durumu da dahil olmak üzere sessionState mesajının geçmiş durum geçişleri.
inactivityTimeout

string (Duration format)

Yalnızca çıkış. Bu cihazın ACTIVE modundan TIMEOUT_INACTIVITY durumuna geçmeden önce etkileşimde bulunması gereken zaman aralığı.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
createTime

string (Timestamp format)

Yalnızca çıkış. Oturumun oluşturulduğu zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
activeStartTime

string (Timestamp format)

Yalnızca çıkış. Oturumun ilk olarak ETKİN hale geldiği zaman damgası.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
androidDevice

object (AndroidDevice)

Zorunlu. İstenen cihaz

Birleştirme alanı expiration.

expiration şunlardan yalnızca biri olabilir:
ttl

string (Duration format)

İsteğe bağlı. Bir cihazın başlangıçta ayrılacağı süre. Bu, sonunda deviceSessions.patch RPC ile genişletilebilir. Varsayılan: 15 dakika.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
expireTime

string (Timestamp format)

İsteğe bağlı. Cihaz bu sırada hâlâ kullanılıyorsa tüm bağlantılar sonlandırılır ve SessionState, ACTIVE durumundan FINISHED durumuna geçirilir.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Oturum Durumu

Cihaz oturumunun bulunduğu durum.

Sıralamalar
SESSION_STATE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
REQUESTED Bir oturum isteğinin ilk durumu. Oturumun doğruluğu doğrulanıyor ve cihaz henüz istenmedi.
PENDING Oturum doğrulandı ve bir cihaz için sıraya alındı.
ACTIVE Oturum onaylandı ve cihaz, bağlantıları kabul ediyor.
EXPIRED Oturum süresi, cihazın rezervasyon süresini aştı ve otomatik olarak zaman aşımına uğradı.
FINISHED Kullanıcı oturumu tamamladı ve istek hâlâ ayrılırken veya ayrıldıktan sonra ve cihaz kullanımı sırasında kullanıcı tarafından iptal edildi.
UNAVAILABLE Cihaz kullanılamıyor ve planlayıcı aracılığıyla tahsis edilemediği için oturum tamamlanamadı. Örneğin, katalogda olmayan bir cihaz istendi veya tahsis sırasında isteğin süresi doldu.
ERROR Altyapı hatası gibi dahili bir nedenden dolayı oturum tamamlanamadı.

SessionStateEtkinlik

Bir dizi Oturum durumunu ve DeviceSession'ın bu durumları ilk kez girdiği zamanı kapsayan bir mesaj.

JSON gösterimi 
{
  "sessionState": enum (SessionState),
  "eventTime": string,
  "stateMessage": string
}
Alanlar
sessionState

enum (SessionState)

Yalnızca çıkış. Bu etkinlik tarafından izlenen sessionState
eventTime

string (Timestamp format)

Yalnızca çıkış. sessionState'in bu durumla ilk karşılaştığı zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
stateMessage

string

Yalnızca çıkış. Durumu açıklayan, kullanıcıların okuyabileceği bir mesaj.

Yöntemler

cancel

 POST /v1/projects/{proje_kimliği}/deviceSessions/{device_session_id}:cancel DeviceSession'ı FINISHED durumuna geçirir ve tüm bağlantıları sonlandırır.

create

 POST /v1/projeler/{proje_kimliği}/deviceSessions

get

 /v1/projects/{proje_kimliği}/deviceSessions/{device_session_id} GET / DeviceSession, atama durumunu ve cihazın ayrılıp ayrılmadığını belgeler.

list

 GET /v1/projects/{project_id}/deviceSessions, Proje kullanıcısına ait cihaz oturumlarını listeler.

patch

 PATCH /v1/projects/{projectId}/deviceSessions/deviceSessionId}:updateDeviceSession Mevcut cihaz oturumunu update_mask tarafından açıklanan alanlara günceller.