Google Apps Script फ़ंक्शन लागू करना

Google Apps Script API की मदद से, किसी ऐसे स्क्रिप्ट प्रोजेक्ट में फ़ंक्शन को रिमोटली (दूर से) एक्ज़ीक्यूट किया जा सकता है जिसे आपने ऐक्सेस किया है. आपका ऐप्लिकेशन, दिए गए Apps Script फ़ंक्शन को कॉल कर सकता है. साथ ही, ज़रूरत पड़ने पर उसे इनपुट पैरामीटर दे सकता है और जवाब पा सकता है.

इस पेज पर दिए गए उदाहरणों से पता चलता है कि एपीआई की मदद से, आम तौर पर इस्तेमाल होने वाले एक्ज़ीक्यूशन ऑपरेशन कैसे किए जा सकते हैं. ज़्यादा जानकारी के लिए, अनुमति से जुड़ी खास शर्तें देखें. इसके अलावा, फ़ंक्शन लागू करना गाइड देखें.

इन उदाहरणों में, scriptId प्लेसहोल्डर का इस्तेमाल यह दिखाने के लिए किया गया है कि आपको स्क्रिप्ट प्रोजेक्ट आईडी कहां देना है. स्क्रिप्ट आईडी ढूंढने के लिए, यहां दिया गया तरीका अपनाएं:

1. Apps Script प्रोजेक्ट में, सबसे ऊपर बाईं ओर मौजूद प्रोजेक्ट सेटिंग पर क्लिक करें.
2. "स्क्रिप्ट आईडी" के बगल में मौजूद, कॉपी करें पर क्लिक करें.

एक फ़ंक्शन निष्पादित करें

यहां दिया गया scripts.run अनुरोध, listFolderContent नाम के Apps Script फ़ंक्शन को कॉल करता है. साथ ही, Google Drive folderId और पूर्णांक MAX_SIZE को आर्ग्युमेंट के तौर पर पास करता है. यह फ़ंक्शन डेवलपमेंट मोड में एक्ज़ीक्यूट होता है. इसका मतलब है कि फ़ंक्शन का हाल ही में सेव किया गया वर्शन एक्ज़ीक्यूट होता है. इससे कोई फ़र्क़ नहीं पड़ता कि एक्ज़ीक्यूटेबल के तौर पर कौनसे वर्शन को डिप्लॉय किया गया है.

अनुरोध प्रोटोकॉल यहां दिखाया गया है. फ़ंक्शन लागू करना गाइड में बताया गया है कि Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके, अलग-अलग भाषाओं में रन करने का अनुरोध कैसे लागू किया जाता है.

POST https://script.googleapis.com/v1/scripts/scriptId:run

{
  "function": "listFolderContent",
  "parameters": [
    folderId,
    MAX_SIZE
  ],
  "devMode": true
}

इस अनुरोध का जवाब, कॉल किए गए Apps Script फ़ंक्शन के पूरा होने के बाद मिलता है. इसमें स्क्रिप्ट के एक्ज़ीक्यूशन के नतीजे या गड़बड़ी का जवाब शामिल होता है. इस उदाहरण में, फ़ंक्शन फ़ाइलों के नामों की एक श्रेणी दिखाता है:

{
  "response": {
    "result": [
      "fileTitle1",
      "fileTitle2",
      "fileTitle3"
    ]
  },
}

अगर Apps Script को लागू करते समय फ़ंक्शन में कोई गड़बड़ी होती है, तो जवाब ऐसा दिख सकता है:

{
  "response": {
    "error": {
      "code": 3,
      "message": "ScriptError",
      "details": [{
        "@type": "type.googleapis.com/google.apps.script.v1.ExecutionError",
        "errorMessage": "The script enountered an exeception it could not resolve.",
        "errorType": "ScriptError",
        "scriptStackTraceElements": [{
          "function": "listFolderContent",
          "lineNumber": 14
        }]
      }]
    }
  }
}