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

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