Method: forms.watches.create

नई स्मार्टवॉच बनाएं. अगर स्मार्टवॉच का आईडी दिया गया है, तो उसका इस्तेमाल नहीं होना चाहिए. शुरू करने वाले हर प्रोजेक्ट के लिए, हर Watch.EventType में एक फ़ॉर्म को देखा जा सकता है. स्मार्टवॉच को बनाए जाने के सात दिन बाद, उसकी समयसीमा खत्म हो जाती है (Watch.expire_time देखें).

एचटीटीपी अनुरोध

POST https://forms.googleapis.com/v1/forms/{formId}/watches

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
formId

string

ज़रूरी है. देखे जाने वाले फ़ॉर्म का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "watch": {
    object (Watch)
  },
  "watchId": string
}
फ़ील्ड
watch

object (Watch)

ज़रूरी है. स्मार्टवॉच का ऑब्जेक्ट. इस ऑब्जेक्ट पर कोई आईडी सेट नहीं होना चाहिए; इसके बजाय, watchId का इस्तेमाल करें.

watchId

string

स्मार्टवॉच के लिए इस्तेमाल किया जाने वाला आईडी. अगर बताया गया है, तो आईडी पहले से इस्तेमाल में नहीं होना चाहिए. अगर इसके लिए तय नहीं किया गया है, तो एक आईडी जनरेट किया जाता है. यह वैल्यू 4 से 63 वर्णों की होनी चाहिए और मान्य वर्ण /[a-z][0-9]-/ हैं.

जवाब का मुख्य भाग

कामयाब होने पर, जवाब के मुख्य हिस्से में Watch का नया इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/forms.body
  • https://www.googleapis.com/auth/forms.body.readonly
  • https://www.googleapis.com/auth/forms.responses.readonly

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.