REST Resource: projects.deviceSessions

संसाधन: Deviceसेशन

डिवाइस के मैसेज की जानकारी देने वाला प्रोटोबफ़ मैसेज, जिसका इस्तेमाल कई आरपीसी से किया गया है.

JSON के काेड में दिखाना
{
  "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.
}
फ़ील्ड
name

string

ज़रूरी नहीं. Deviceसेशन का नाम, जैसे कि "प्रोजेक्ट/{projectId}/deviceसेशन/{session_id}"

displayName

string

सिर्फ़ आउटपुट के लिए. यूज़र इंटरफ़ेस (यूआई) में दिखने वाले Deviceसेशन का टाइटल.

state

enum (SessionState)

सिर्फ़ आउटपुट के लिए. Deviceसेशन की मौजूदा स्थिति.

stateHistories[]

object (SessionStateEvent)

सिर्फ़ आउटपुट के लिए. मौजूदा सेशन की स्थिति के साथ, sessionState मैसेज के पुराने स्टेटस का ट्रांज़िशन.

inactivityTimeout

string (Duration format)

सिर्फ़ आउटपुट के लिए. समय का वह अंतराल जिसके साथ इस डिवाइस को ACTIVE से BYTES_INACTIVITY में बदलने से पहले सहभागिता किया जाना चाहिए.

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. सेशन बनाने का समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

activeStartTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जब सेशन पहली बार चालू हुआ.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

androidDevice

object (AndroidDevice)

ज़रूरी है. अनुरोध किया गया डिवाइस

यूनियन फ़ील्ड expiration.

expiration इनमें से सिर्फ़ एक हो सकता है:

ttl

string (Duration format)

ज़रूरी नहीं. वह समय जिसके लिए शुरुआत में डिवाइस को असाइन किया जाएगा. डिवाइस के सेशन.पैच RPC की मदद से, इस अवधि को बढ़ाया जा सकता है. डिफ़ॉल्ट: 15 मिनट.

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

expireTime

string (Timestamp format)

ज़रूरी नहीं. अगर डिवाइस अब भी इस समय इस्तेमाल में है, तो सभी कनेक्शन खत्म हो जाएंगे. साथ ही, SessionState, ACTIVE से FINISHED में बदल जाएगा.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

सेशन की स्थिति

वह स्थिति जिसमें डिवाइस सेशन मौजूद है.

एनम्स
SESSION_STATE_UNSPECIFIED डिफ़ॉल्ट मान. इस वैल्यू का इस्तेमाल नहीं किया गया है.
REQUESTED सेशन के अनुरोध की शुरुआती स्थिति. सेशन के सही होने की पुष्टि की जा रही है और अभी तक किसी डिवाइस का अनुरोध नहीं किया गया है.
PENDING इस सेशन की पुष्टि हो गई है और यह डिवाइस की सूची में है.
ACTIVE सेशन पूरा हो गया है और डिवाइस, कनेक्शन स्वीकार कर रहा है.
EXPIRED सत्र की अवधि, डिवाइस की आरक्षण समयावधि से ज़्यादा हो गई और अपने आप उसका समय खत्म हो गया.
FINISHED उपयोगकर्ता का सेशन खत्म हो जाता है और डिवाइस के इस्तेमाल की अवधि के दौरान, अनुरोध असाइन होने या असाइन होने के बाद भी उपयोगकर्ता ने उसे रद्द कर दिया था.
UNAVAILABLE डिवाइस उपलब्ध न होने और शेड्यूलर के ज़रिए असाइन नहीं किया जा सका, इसलिए सेशन पूरा नहीं किया जा सका. उदाहरण के लिए, किसी ऐसे डिवाइस के लिए अनुरोध किया गया जो कैटलॉग में मौजूद नहीं है या अनुरोध की समयसीमा खत्म हो गई है.
ERROR किसी अंदरूनी वजह, जैसे कि इन्फ़्रास्ट्रक्चर की गड़बड़ी से सेशन पूरा नहीं हो सका.

सेशन स्टेटइवेंट

यह एक मैसेज है, जिसमें सेशन की स्थितियों की सीरीज़ और डिवाइस सेशन के पहली बार आने का समय शामिल होता है.

JSON के काेड में दिखाना
{
  "sessionState": enum (SessionState),
  "eventTime": string,
  "stateMessage": string
}
फ़ील्ड
sessionState

enum (SessionState)

सिर्फ़ आउटपुट के लिए. इस इवेंट से ट्रैक की गई sessionState

eventTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह समय जब sessionState का पहली बार उस स्थिति से सामना किया गया.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

stateMessage

string

सिर्फ़ आउटपुट के लिए. राज्य के बारे में जानकारी देने वाला ऐसा मैसेज जिसे कोई भी व्यक्ति आसानी से पढ़ सके.

तरीके

cancel

POST /v1/projects/{project_id}/devicesession/{device_session_id}:cancel डिवाइससेशन को FINISHED स्थिति में बदल देता है और सभी कनेक्शन बंद कर देता है.

create

POST /v1/projects/{project_id}/deviceसेशन

get

GET /v1/projects/{project_id}/deviceसेशन/{device_session_id} डिवाइससेशन वापस करें, जो ऐलोकेशन की स्थिति की जानकारी देता है और यह भी बताता है कि डिवाइस असाइन किया गया है या नहीं.

list

GET /v1/projects/{project_id}/device निशान, प्रोजेक्ट के उपयोगकर्ता के मालिकाना हक वाले डिवाइस सेशन की सूची बनाता है.

patch

PATCH /v1/projects/{projectId}/device लर्निंग/device ज़रूरतोंId}:updateDevicesession अपडेट_मास्क में बताए गए फ़ील्ड के लिए, डिवाइस के मौजूदा सेशन को अपडेट करता है.