REST Resource: forms.watches

संसाधन: देखें

किसी फ़ॉर्म के इवेंट के लिए स्मार्टवॉच. जब कोई खास इवेंट होगा, तो तय किए गए टारगेट पर एक सूचना पब्लिश की जाएगी. सूचना के एट्रिब्यूट में एक formId कुंजी शामिल होगी, जिसमें देखे गए फ़ॉर्म का आईडी होगा. साथ ही, एक eventType कुंजी होगी, जिसमें इस तरह की स्ट्रिंग होगी.

मैसेज को कम से कम एक बार डिलीवर किया जाता है और खास स्थितियों में ही उन्हें भेजा जाता है. आम तौर पर, सभी सूचनाएं कुछ ही सेकंड में डिलीवर हो जाती हैं. हालांकि, कुछ स्थितियों में सूचनाएं मिलने में देरी हो सकती है.

स्मार्टवॉच बनाने के सात दिन बाद, उसे watches.renew पर रिन्यू नहीं किया जा सकता.

जेएसओएन के काेड में दिखाना
{
  "id": string,
  "target": {
    object (WatchTarget)
  },
  "eventType": enum (EventType),
  "createTime": string,
  "expireTime": string,
  "errorType": enum (ErrorType),
  "state": enum (State)
}
फ़ील्ड
id

string

सिर्फ़ आउटपुट के लिए. इस स्मार्टवॉच का आईडी. CreateWatchRequest.watch_id पर नोट देखें.

target

object (WatchTarget)

ज़रूरी है. सूचना कहां भेजें.

eventType

enum (EventType)

ज़रूरी है. किस तरह का इवेंट देखना है.

createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. उस समय का टाइमस्टैंप जब इसे बनाया गया था.

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

expireTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस समयावधि के खत्म होने का टाइमस्टैंप. हर watches.renew कॉल, इसे अगले सात दिनों पर रीसेट करता है.

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

errorType

enum (ErrorType)

सिर्फ़ आउटपुट के लिए. डिलीवरी की कोशिश करने के लिए, हाल ही में हुई गड़बड़ी का टाइप. फ़ॉर्म को फिर से देखने के लिए, watches.renew पर कॉल किया जा सकता है. इससे गड़बड़ी की जानकारी भी हट जाती है.

state

enum (State)

सिर्फ़ आउटपुट के लिए. स्मार्टवॉच की मौजूदा स्थिति. निलंबित की गई स्मार्टवॉच के बारे में ज़्यादा जानकारी पाने के लिए, errorType पर जाएं.

WatchTarget

सूचना डिलीवरी का टारगेट.

जेएसओएन के काेड में दिखाना
{

  // Union field target can be only one of the following:
  "topic": {
    object (CloudPubsubTopic)
  }
  // End of list of possible types for union field target.
}
फ़ील्ड
यूनियन फ़ील्ड target. ज़रूरी है. सूचना डिलीवरी का टारगेट. target इनमें से सिर्फ़ एक हो सकता है:
topic

object (CloudPubsubTopic)

Pub/Sub विषय. सूचनाएं पाने के लिए, विषय को Forms सेवा खाते serviceAccount:forms-notifications@system.gserviceaccount.com को पब्लिश करने के खास अधिकार देने होंगे. किसी विषय का मालिकाना हक रखने वाला प्रोजेक्ट ही इसके साथ स्मार्टवॉच बना सकता है.

Pub/Sub डिलीवरी की गारंटी को ध्यान में रखा जाना चाहिए.

CloudPubsubTopic

Pub/Sub विषय.

जेएसओएन के काेड में दिखाना
{
  "topicName": string
}
फ़ील्ड
topicName

string

ज़रूरी है. इवेंट पब्लिश करने के लिए, पूरी तरह क्वालिफ़ाइड Pub/Sub विषय का नाम. इस विषय का मालिकाना हक, कॉल करने वाले प्रोजेक्ट के पास होना चाहिए. साथ ही, यह विषय पहले से ही Pub/Sub में मौजूद होना चाहिए.

EventType

देखे जा सकने वाले संभावित इवेंट टाइप.

Enums
EVENT_TYPE_UNSPECIFIED इवेंट टाइप की जानकारी नहीं है. इस वैल्यू का इस्तेमाल नहीं किया जाना चाहिए.
SCHEMA स्कीमा इवेंट टाइप. फ़ॉर्म के कॉन्टेंट और सेटिंग में हुए बदलावों के बारे में, इस तरह के इवेंट वाली स्मार्टवॉच को सूचना दी जाएगी.
RESPONSES जवाबों से जुड़े इवेंट का टाइप. फ़ॉर्म में जवाब सबमिट किए जाने पर, इस तरह के इवेंट वाली स्मार्टवॉच को सूचना दी जाएगी.

ErrorType

संभावित गड़बड़ी प्रकार.

Enums
ERROR_TYPE_UNSPECIFIED गड़बड़ी के टाइप की जानकारी नहीं है.
PROJECT_NOT_AUTHORIZED क्लाउड प्रोजेक्ट के पास देखे जा रहे फ़ॉर्म का ऐक्सेस नहीं है. ऐसा तब होता है, जब उपयोगकर्ता ने फ़ॉर्म को ऐक्सेस करने के लिए, आपके प्रोजेक्ट को दी गई अनुमति को रद्द कर दिया हो. इस गड़बड़ी वाली स्मार्टवॉच को फिर से बनाने की कोशिश नहीं की जाएगी. फ़ॉर्म को फिर से देखने के लिए, watches.renew पर कॉल किया जा सकता है
NO_USER_ACCESS ऐक्सेस देने वाले उपयोगकर्ता के पास, अब देखे जा रहे फ़ॉर्म का ऐक्सेस नहीं है. इस गड़बड़ी वाली स्मार्टवॉच को फिर से बनाने की कोशिश नहीं की जाएगी. फ़ॉर्म को फिर से देखने के लिए, watches.renew पर कॉल किया जा सकता है
OTHER_ERRORS किसी अन्य तरह की गड़बड़ी हुई है. सूचनाएं पाना जारी रखा जाएगा या नहीं, यह स्मार्टवॉच की state पर निर्भर करता है.

स्थिति

वॉच की स्थिति क्या हो सकती है.

Enums
STATE_UNSPECIFIED स्थिति सेट नहीं की गई है.
ACTIVE स्मार्टवॉच चालू है.
SUSPENDED किसी गड़बड़ी की वजह से स्मार्टवॉच निलंबित कर दी गई है. हालांकि, ऐसा हो सकता है कि इसे ठीक कर लिया गया हो. स्मार्टवॉच तब तक मौजूद रहेगी, जब तक उसकी समयसीमा खत्म नहीं हो जाती. स्मार्टवॉच को फिर से चालू करने के लिए, watches.renew पर कॉल करें

तरीके

create

नई स्मार्टवॉच बनाएं.

delete

किसी स्मार्टवॉच को मिटाना.

list

अनुरोध करने वाले प्रोजेक्ट के मालिकाना हक वाली स्मार्टवॉच की सूची दें.

renew

किसी मौजूदा स्मार्टवॉच को सात दिनों के लिए रिन्यू करें.