Class ScriptApp

दिए गए ट्रिगर को हटाता है, ताकि वह अब न चले.

// Deletes all triggers in the current project.
const triggers = ScriptApp.getProjectTriggers();
for (let i = 0; i < triggers.length; i++) {
  ScriptApp.deleteTrigger(triggers[i]);
}

पैरामीटर

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/script.scriptapp

एक ऑब्जेक्ट पाता है, जो यह जांच करता है कि उपयोगकर्ता ने स्क्रिप्ट की सभी ज़रूरी शर्तों के लिए अनुमति दी है या नहीं. अगर स्क्रिप्ट की किसी ज़रूरी शर्त को अनुमति नहीं दी जाती है, तो उपयोगकर्ताओं को अनुमति देने के लिए ऑब्जेक्ट, अनुमति देने वाला यूआरएल भी उपलब्ध कराता है.

स्क्रिप्ट के इस्तेमाल किए गए सभी ज़रूरी स्कोप के लिए, उपयोगकर्ता की सहमति के बिना कुछ स्क्रिप्ट की प्रोसेस शुरू हो सकती है. इस ऑब्जेक्ट में मौजूद जानकारी की मदद से, कोड के उन सेक्शन का ऐक्सेस कंट्रोल किया जा सकता है जिनके लिए कुछ स्कोप की ज़रूरत होती है. साथ ही, बाद में उन स्कोप को लागू करने के लिए अनुमति का अनुरोध किया जा सकता है.

const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
const status = authInfo.getAuthorizationStatus();
const url = authInfo.getAuthorizationUrl();

पैरामीटर

वापसी का टिकट

AuthorizationInfo — यह एक ऐसा ऑब्जेक्ट है जो उपयोगकर्ता की अनुमति की स्थिति के बारे में जानकारी दे सकता है.

एक ऑब्जेक्ट मिलता है, जो यह जांच करता है कि उपयोगकर्ता ने अनुरोध किए गए स्कोप के लिए अनुमति दी है या नहीं. अगर अनुरोध किए गए किसी स्कोप को अनुमति नहीं दी जाती है, तो ऑब्जेक्ट में उपयोगकर्ताओं को अनुमति देने के लिए, अनुमति देने वाला यूआरएल भी दिया जाता है.

स्क्रिप्ट के इस्तेमाल किए गए सभी ज़रूरी स्कोप के लिए, उपयोगकर्ता की सहमति के बिना कुछ स्क्रिप्ट की प्रोसेस शुरू हो सकती है. इस ऑब्जेक्ट में मौजूद जानकारी की मदद से, कोड के उन सेक्शन का ऐक्सेस कंट्रोल किया जा सकता है जिनके लिए कुछ स्कोप की ज़रूरत होती है. साथ ही, बाद में उन स्कोप को लागू करने के लिए अनुमति का अनुरोध किया जा सकता है. अमान्य स्कोप या स्क्रिप्ट के लिए ज़रूरी नहीं होने वाले स्कोप की वजह से गड़बड़ी होती है.

const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [
  'https://www.googleapis.com/auth/documents',
  'https://www.googleapis.com/auth/presentations',
]);
const status = authInfo.getAuthorizationStatus();
const url = authInfo.getAuthorizationUrl();

पैरामीटर

वापसी का टिकट

AuthorizationInfo — यह एक ऑब्जेक्ट है, जो उपयोगकर्ता की अनुमति की स्थिति के बारे में जानकारी देता है. साथ ही, कुछ सहमतियों के न होने पर, अनुमति देने वाले यूआरएल की जानकारी भी देता है.

अगर openid स्कोप दिया गया है, तो असरदार उपयोगकर्ता के लिए OpenID Connect आइडेंटिटी टोकन मिलता है. यह स्कोप डिफ़ॉल्ट रूप से शामिल नहीं होता. इसका अनुरोध करने के लिए, आपको इसे मेनिफ़ेस्ट फ़ाइल में साफ़ तौर पर स्कोप के तौर पर जोड़ना होगा. टोकन में उपयोगकर्ता की ज़्यादा जानकारी दिखाने के लिए, https://www.googleapis.com/auth/userinfo.email या https://www.googleapis.com/auth/userinfo.profile स्कोप शामिल करें.

दिखाया गया आईडी टोकन, कोड में बदला गया JSON वेब टोकन (JWT) होता है. इसमें से जानकारी निकालने के लिए, इसे डिकोड करना ज़रूरी होता है. नीचे दिए गए उदाहरणों में, टोकन को डिकोड करने और असरदार उपयोगकर्ता का Google प्रोफ़ाइल आईडी निकालने का तरीका बताया गया है.

const idToken = ScriptApp.getIdentityToken();
const body = idToken.split('.')[1];
const decoded = Utilities
                    .newBlob(
                        Utilities.base64Decode(body),
                        )
                    .getDataAsString();
const payload = JSON.parse(decoded);

Logger.log(`Profile ID: ${payload.sub}`);

वापसी का टिकट

String — अगर आइडेंटिटी टोकन उपलब्ध है, तो उसका इस्तेमाल करें. अगर उपलब्ध नहीं है, तो null का इस्तेमाल करें.

यह एक एनम वैल्यू दिखाता है. इससे पता चलता है कि मौजूदा उपयोगकर्ता के लिए, स्क्रिप्ट को ऐड-ऑन के तौर पर कैसे इंस्टॉल किया गया. उदाहरण के लिए, क्या उपयोगकर्ता ने इसे Chrome Web Store से खुद इंस्टॉल किया है या डोमेन एडमिन ने इसे सभी उपयोगकर्ताओं के लिए इंस्टॉल किया है.

वापसी का टिकट

InstallationSource — इंस्टॉल करने का सोर्स.

असरदार उपयोगकर्ता के लिए OAuth 2.0 ऐक्सेस टोकन पाता है. अगर स्क्रिप्ट के OAuth स्कोप, किसी ऐसे दूसरे Google API को अनुमति देने के लिए काफ़ी हैं जिसे आम तौर पर अपने OAuth फ़्लो (जैसे, Google पिकर) की ज़रूरत होती है, तो स्क्रिप्ट इस टोकन को पास करके, अनुमति के लिए पूछे जाने वाले दूसरे सवाल को बायपास कर सकती हैं. टोकन की समयसीमा कुछ समय (कम से कम कुछ मिनट) बाद खत्म हो जाती है. स्क्रिप्ट को अनुमति न मिलने की समस्या को मैनेज करना चाहिए और ज़रूरत पड़ने पर नया टोकन पाने के लिए, इस तरीके को कॉल करना चाहिए.

इस तरीके से मिले टोकन में सिर्फ़ वे स्कोप शामिल होते हैं जिनकी फ़िलहाल स्क्रिप्ट को ज़रूरत होती है. जिन स्कोप को पहले अनुमति दी गई थी, लेकिन अब स्क्रिप्ट में उनका इस्तेमाल नहीं किया जाता है उन्हें दिखाए गए टोकन में शामिल नहीं किया जाता. अगर स्क्रिप्ट के लिए ज़रूरी OAuth स्कोप के अलावा, और OAuth स्कोप की ज़रूरत है, तो उन्हें स्क्रिप्ट की मेनिफ़ेस्ट फ़ाइल में तय किया जा सकता है.

वापसी का टिकट

String — OAuth 2.0 टोकन की स्ट्रिंग.

मौजूदा प्रोजेक्ट और मौजूदा उपयोगकर्ता से जुड़े, इंस्टॉल किए जा सकने वाले सभी ट्रिगर दिखाता है.

Logger.log(
    `Current project has ${ScriptApp.getProjectTriggers().length} triggers.`,
);

वापसी का टिकट

Trigger[] — इस प्रोजेक्ट से जुड़े मौजूदा उपयोगकर्ता के ट्रिगर का कलेक्शन.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/script.scriptapp

स्क्रिप्ट प्रोजेक्ट का यूनीक आईडी पाता है. getProjectKey() के बजाय, स्क्रिप्ट प्रोजेक्ट के लिए यूनीक आइडेंटिफ़ायर पाने का यह सबसे अच्छा तरीका है. इस आईडी का इस्तेमाल उन सभी जगहों पर किया जा सकता है जहां पहले प्रोजेक्ट पासकोड दिया गया था.

वापसी का टिकट

String — स्क्रिप्ट प्रोजेक्ट का आईडी.

यह एक ऑब्जेक्ट दिखाता है, जिसका इस्तेमाल स्क्रिप्ट को वेब ऐप्लिकेशन के तौर पर पब्लिश करने के लिए किया जाता है.

// Get the URL of the published web app.
const url = ScriptApp.getService().getUrl();

वापसी का टिकट

Service — यह एक ऑब्जेक्ट है, जिसका इस्तेमाल स्क्रिप्ट को वेब ऐप्लिकेशन के तौर पर पब्लिश करने की प्रक्रिया को मॉनिटर करने और कंट्रोल करने के लिए किया जाता है.

इस दस्तावेज़ में, इस स्क्रिप्ट या ऐड-ऑन के लिए, इस उपयोगकर्ता के मालिकाना हक वाले सभी इंस्टॉल किए जा सकने वाले ट्रिगर दिखाता है. इस तरीके का इस्तेमाल, दूसरी स्क्रिप्ट से जुड़े ट्रिगर देखने के लिए नहीं किया जा सकता.

const doc = DocumentApp.getActiveDocument();
const triggers = ScriptApp.getUserTriggers(doc);
// Log the handler function for the first trigger in the array.
Logger.log(triggers[0].getHandlerFunction());

पैरामीटर

वापसी का टिकट

Trigger[] — दिए गए दस्तावेज़ में, इस उपयोगकर्ता के मालिकाना हक वाले ट्रिगर का कलेक्शन.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/script.scriptapp

इस फ़ॉर्म में, इस स्क्रिप्ट या ऐड-ऑन के लिए, इंस्टॉल किए जा सकने वाले सभी ट्रिगर दिखाता है. इस तरीके का इस्तेमाल, दूसरी स्क्रिप्ट से जुड़े ट्रिगर देखने के लिए नहीं किया जा सकता.

const form = FormApp.getActiveForm();
const triggers = ScriptApp.getUserTriggers(form);
// Log the trigger source for the first trigger in the array.
Logger.log(triggers[0].getTriggerSource());

पैरामीटर

वापसी का टिकट

Trigger[] — दिए गए फ़ॉर्म में, इस उपयोगकर्ता के मालिकाना हक वाले ट्रिगर का कलेक्शन.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/script.scriptapp

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

const ss = SpreadsheetApp.getActiveSpreadsheet();
const triggers = ScriptApp.getUserTriggers(ss);
// Log the event type for the first trigger in the array.
Logger.log(triggers[0].getEventType());

पैरामीटर

वापसी का टिकट

Trigger[] — दी गई स्प्रेडशीट में, इस उपयोगकर्ता के मालिकाना हक वाले ट्रिगर का कलेक्शन.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/script.scriptapp

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

ScriptApp.invalidateAuth();

थ्रो

Error — जब पुष्टि नहीं हो पाती

स्टेटस टोकन के लिए बिल्डर बनाता है. इसका इस्तेमाल, OAuth फ़्लो जैसे कॉलबैक एपीआई में किया जा सकता है.

// Generate a callback URL, given the name of a callback function. The script
// does not need to be published as a web app; the /usercallback URL suffix
// replaces /edit in any script's URL.
function getCallbackURL(callbackFunction) {
  // IMPORTANT: Replace string below with the URL from your script, minus the
  // /edit at the end.
  const scriptUrl =
      'https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz';
  const urlSuffix = '/usercallback?state=';
  const stateToken = ScriptApp.newStateToken()
                         .withMethod(callbackFunction)
                         .withTimeout(120)
                         .createToken();
  return scriptUrl + urlSuffix + stateToken;
}

ज़्यादातर OAuth2 फ़्लो में, state टोकन को सीधे ऑथराइज़ेशन एंडपॉइंट पर भेजा जाता है, न कि कॉलबैक यूआरएल के हिस्से के तौर पर. इसके बाद, ऑथराइज़ेशन एंडपॉइंट उसे कॉलबैक यूआरएल के हिस्से के तौर पर भेजता है.

उदाहरण के लिए:

• स्क्रिप्ट, उपयोगकर्ता को OAuth2 के ऑथराइज़ेशन यूआरएल पर रीडायरेक्ट करती है: https://accounts.google.com/o/oauth2/auth?state=token_generated_with_this_method&callback_uri=https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz/usercallback&other_oauth2_parameters
• उपयोगकर्ता, 'अनुमति दें' पर क्लिक करता है. इसके बाद, OAuth2 अनुमति पेज, उपयोगकर्ता को वापस https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz/usercallback?state=token_generated_with_this_method&other_params_that_include_tokens_or_grants पर रीडायरेक्ट करता है
• ऊपर दिए गए रीडायरेक्ट (http://script.google.com/... पर वापस) की वजह से, ब्राउज़र /usercallback से अनुरोध करता है. यह अनुरोध, StateTokenBuilder.withMethod(method) में बताए गए तरीके को लागू करता है.

वापसी का टिकट

StateTokenBuilder — यह एक ऐसा ऑब्जेक्ट है जिसका इस्तेमाल, स्टेट-टोकन बनाने की प्रोसेस को जारी रखने के लिए किया जाता है.

इंस्टॉल किए जा सकने वाले ट्रिगर बनाने की प्रोसेस शुरू करता है. ट्रिगर होने पर, यह किसी फ़ंक्शन को कॉल करता है.

// Creates an edit trigger for a spreadsheet identified by ID.
ScriptApp.newTrigger('myFunction')
    .forSpreadsheet('1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3')
    .onEdit()
    .create();

पैरामीटर

वापसी का टिकट

TriggerBuilder — ट्रिगर बनाने की प्रोसेस जारी रखने के लिए इस्तेमाल किया जाने वाला ऑब्जेक्ट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

• https://www.googleapis.com/auth/script.scriptapp

यह पुष्टि करता है कि उपयोगकर्ता ने स्क्रिप्ट के अनुरोध किए गए सभी स्कोप के लिए सहमति दी है या नहीं. अगर कोई एक्सीक्यूशन फ़्लो, उन सभी स्कोप पर निर्भर करता है जिनका अनुरोध स्क्रिप्ट करती है, तो इस तरीके का इस्तेमाल करें. अगर कोई सहमति मौजूद नहीं है, तो यह तरीका मौजूदा प्रोसेस को खत्म कर देता है. साथ ही, मौजूदा सहमतियों का अनुरोध करने के लिए, अनुमति का अनुरोध दिखाता है.

यह तरीका सिर्फ़ तब काम करता है, जब उपयोगकर्ता किसी ऐसे प्लैटफ़ॉर्म से स्क्रिप्ट चलाते हैं जो ज़्यादा जानकारी वाली सहमति के साथ काम करता है. उदाहरण के लिए, Apps Script IDE से. जब स्क्रिप्ट को ऐसे प्लैटफ़ॉर्म पर चलाया जाता है जहां सहमति नहीं मिलती, जैसे कि Google Workspace का कोई ऐड-ऑन, तो स्क्रिप्ट सभी स्कोप का अनुरोध करने के लिए, शुरू में अनुमति का अनुरोध दिखाती है.

ScriptApp.requireAllScopes(ScriptApp.AuthMode.FULL);

पैरामीटर

यह पुष्टि करता है कि उपयोगकर्ता ने अनुरोध किए गए स्कोप के लिए सहमति दी है या नहीं. अगर कोई प्रोसेस एक या उससे ज़्यादा सेवाओं पर निर्भर करती है, तो इस तरीके का इस्तेमाल करें. अगर बताई गई सहमतियों में से कोई भी सहमति मौजूद नहीं है, तो यह तरीका मौजूदा प्रोसेस को खत्म कर देता है. साथ ही, मौजूदा सहमतियों के अनुरोध के लिए अनुमति वाला प्रॉम्प्ट दिखाता है. अमान्य स्कोप या स्क्रिप्ट के लिए ज़रूरी नहीं होने वाले स्कोप की वजह से गड़बड़ी होती है.

यह तरीका सिर्फ़ तब काम करता है, जब उपयोगकर्ता किसी ऐसे प्लैटफ़ॉर्म से स्क्रिप्ट चलाते हैं जो ज़्यादा जानकारी वाली सहमति के साथ काम करता है. उदाहरण के लिए, Apps Script IDE से. जब स्क्रिप्ट को ऐसे प्लैटफ़ॉर्म पर चलाया जाता है जहां सहमति नहीं मिलती, जैसे कि Google Workspace का कोई ऐड-ऑन, तो स्क्रिप्ट सभी स्कोप का अनुरोध करने के लिए, शुरू में अनुमति का अनुरोध दिखाती है.

ScriptApp.requireScopes(ScriptApp.AuthMode.FULL, [
  'https://www.googleapis.com/auth/documents',
  'https://www.googleapis.com/auth/presentations',
]);

पैरामीटर