Method: forms.watches.create

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
formId

string

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "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

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