Class ScriptApp

স্ক্রিপ্টঅ্যাপ

স্ক্রিপ্ট প্রকাশনা এবং ট্রিগারগুলি অ্যাক্সেস এবং ম্যানিপুলেট করুন। এই ক্লাসটি ব্যবহারকারীদের স্ক্রিপ্ট ট্রিগার তৈরি করতে এবং একটি পরিষেবা হিসাবে স্ক্রিপ্ট প্রকাশকে নিয়ন্ত্রণ করতে দেয়।

বৈশিষ্ট্য

সম্পত্তি টাইপ বর্ণনা
AuthMode AuthMode একটি গণনা যা শনাক্ত করে যে অনুমোদিত পরিষেবাগুলির কোন বিভাগগুলি অ্যাপস স্ক্রিপ্ট একটি ট্রিগার ফাংশনের মাধ্যমে কার্যকর করতে সক্ষম।
AuthorizationStatus AuthorizationStatus একটি স্ক্রিপ্টের অনুমোদনের অবস্থা নির্দেশ করে একটি গণনা৷
EventType EventType ট্রিগার হওয়া ইভেন্টের ধরন নির্দেশ করে একটি গণনা।
InstallationSource InstallationSource অ্যাড-অন হিসাবে ব্যবহারকারীর কাছে স্ক্রিপ্টটি কীভাবে ইনস্টল করা হয়েছিল তা নির্দেশ করে একটি গণনা।
TriggerSource TriggerSource ইভেন্টের উৎস নির্দেশ করে এমন একটি গণনা যা ট্রিগারটিকে ফায়ার করে।
WeekDay Weekday সপ্তাহের দিনগুলির প্রতিনিধিত্বকারী একটি গণনা৷

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
deleteTrigger(trigger) void প্রদত্ত ট্রিগারটি সরিয়ে দেয় যাতে এটি আর চলে না।
getAuthorizationInfo(authMode) AuthorizationInfo ব্যবহারকারীর এক বা একাধিক পরিষেবা ব্যবহার করার জন্য এই স্ক্রিপ্টটিকে অনুমোদন করতে হবে কিনা এবং একটি অনুমোদন ডায়ালগের জন্য URL প্রদান করতে হবে কিনা তা নির্ধারণ করতে একটি বস্তু ব্যবহার করা হয়৷
getIdentityToken() String কার্যকর ব্যবহারকারীর জন্য একটি OpenID Connect পরিচয় টোকেন পায়, যদি openid সুযোগ মঞ্জুর করা হয়।
getInstallationSource() InstallationSource একটি enum মান প্রদান করে যা নির্দেশ করে যে স্ক্রিপ্টটি বর্তমান ব্যবহারকারীর জন্য অ্যাড-অন হিসাবে কীভাবে ইনস্টল করা হয়েছে (উদাহরণস্বরূপ, ব্যবহারকারী এটি Chrome ওয়েব স্টোরের মাধ্যমে ব্যক্তিগতভাবে ইনস্টল করেছেন কিনা, বা একজন ডোমেন প্রশাসক এটি সমস্ত ব্যবহারকারীর জন্য ইনস্টল করেছেন কিনা)৷
getOAuthToken() String কার্যকর ব্যবহারকারীর জন্য OAuth 2.0 অ্যাক্সেস টোকেন পায়।
getProjectTriggers() Trigger[] বর্তমান প্রকল্প এবং বর্তমান ব্যবহারকারীর সাথে যুক্ত সমস্ত ইনস্টলযোগ্য ট্রিগার পায়।
getScriptId() String স্ক্রিপ্ট প্রকল্পের অনন্য আইডি পায়।
getService() Service একটি ওয়েব অ্যাপ হিসাবে স্ক্রিপ্ট প্রকাশ নিয়ন্ত্রণ করতে ব্যবহৃত একটি বস্তু পায়।
getUserTriggers(document) Trigger[] এই স্ক্রিপ্ট বা অ্যাড-অনের জন্য প্রদত্ত নথিতে এই ব্যবহারকারীর মালিকানাধীন সমস্ত ইনস্টলযোগ্য ট্রিগার পায়৷
getUserTriggers(form) Trigger[] এই স্ক্রিপ্ট বা অ্যাড-অনের জন্য প্রদত্ত ফর্মে এই ব্যবহারকারীর মালিকানাধীন সমস্ত ইনস্টলযোগ্য ট্রিগার পায়৷
getUserTriggers(spreadsheet) Trigger[] প্রদত্ত স্প্রেডশীটে এই ব্যবহারকারীর মালিকানাধীন সমস্ত ইনস্টলযোগ্য ট্রিগার পায়, শুধুমাত্র এই স্ক্রিপ্ট বা অ্যাড-অনের জন্য।
invalidateAuth() void বর্তমান স্ক্রিপ্টটি কার্যকর করার জন্য কার্যকর ব্যবহারকারীর অনুমোদন বাতিল করে।
newStateToken() StateTokenBuilder একটি কলব্যাক API (যেমন একটি OAuth ফ্লো) ব্যবহার করা যেতে পারে এমন একটি রাজ্য টোকেনের জন্য একটি নির্মাতা তৈরি করে৷
newTrigger(functionName) TriggerBuilder একটি ইন্সটলযোগ্য ট্রিগার তৈরি করার প্রক্রিয়া শুরু করে যেটি, যখন ফায়ার করা হয়, একটি প্রদত্ত ফাংশনকে কল করে।

বিস্তারিত ডকুমেন্টেশন

deleteTrigger(trigger)

প্রদত্ত ট্রিগারটি সরিয়ে দেয় যাতে এটি আর চলে না।

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

পরামিতি

নাম টাইপ বর্ণনা
trigger Trigger মুছে ফেলার ট্রিগার।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

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

getAuthorizationInfo(authMode)

ব্যবহারকারীর এক বা একাধিক পরিষেবা ব্যবহার করার জন্য এই স্ক্রিপ্টটিকে অনুমোদন করতে হবে কিনা এবং একটি অনুমোদন ডায়ালগের জন্য URL প্রদান করতে হবে কিনা তা নির্ধারণ করতে একটি বস্তু ব্যবহার করা হয়৷ যদি স্ক্রিপ্টটি একটি অ্যাড-অন হিসাবে প্রকাশিত হয় যা ইনস্টলযোগ্য ট্রিগার ব্যবহার করে, এই তথ্যটি কোডের বিভাগগুলিতে অ্যাক্সেস নিয়ন্ত্রণ করতে ব্যবহার করা যেতে পারে যার জন্য ব্যবহারকারীর প্রয়োজনীয় অনুমোদনের অভাব রয়েছে৷ বিকল্পভাবে, অ্যাড-অন ব্যবহারকারীকে সমস্যা সমাধানের জন্য অনুমোদন ডায়ালগের URL খুলতে বলতে পারে।

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

পরামিতি

নাম টাইপ বর্ণনা
authMode AuthMode অনুমোদনের মোড যার জন্য অনুমোদন তথ্য অনুরোধ করা হয়েছে; প্রায় সব ক্ষেত্রেই, authMode এর মান ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL) হওয়া উচিত, যেহেতু অন্য কোনও অনুমোদন মোডের জন্য ব্যবহারকারীদের অনুমোদন দেওয়ার প্রয়োজন নেই

প্রত্যাবর্তন

AuthorizationInfo — এমন একটি বস্তু যা ব্যবহারকারীর অনুমোদনের অবস্থা সম্পর্কে তথ্য প্রদান করতে পারে


getIdentityToken()

কার্যকর ব্যবহারকারীর জন্য একটি OpenID Connect পরিচয় টোকেন পায়, যদি openid সুযোগ মঞ্জুর করা হয়। এই সুযোগটি ডিফল্টরূপে অন্তর্ভুক্ত করা হয় না, এবং এটির অনুরোধ করার জন্য আপনাকে ম্যানিফেস্ট ফাইলে একটি সুস্পষ্ট সুযোগ হিসাবে এটি যোগ করতে হবে৷ টোকেনে অতিরিক্ত ব্যবহারকারীর তথ্য ফেরত দিতে স্কোপগুলি অন্তর্ভুক্ত করুন https://www.googleapis.com/auth/userinfo.email বা https://www.googleapis.com/auth/userinfo.profile

প্রত্যাবর্তিত আইডি টোকেনটি একটি এনকোড করা JSON ওয়েব টোকেন (JWT) , এবং এটি থেকে তথ্য বের করার জন্য এটিকে অবশ্যই ডিকোড করতে হবে। নিম্নলিখিত উদাহরণগুলি দেখায় কিভাবে টোকেন ডিকোড করতে হয় এবং কার্যকর ব্যবহারকারীর Google প্রোফাইল আইডি বের করতে হয়।

var idToken = ScriptApp.getIdentityToken();
var body = idToken.split('.')[1];
var decoded = Utilities.newBlob(Utilities.base64Decode(body)).getDataAsString();
var payload = JSON.parse(decoded);
var profileId = payload.sub;
Logger.log('Profile ID: ' + profileId);
ফিরে আসা ক্ষেত্রগুলির (দাবি) সম্পূর্ণ তালিকার জন্য OpenID Connect ডকুমেন্টেশন দেখুন।

প্রত্যাবর্তন

String — পরিচয় টোকেন যদি উপলব্ধ থাকে; অন্যথায় null


getInstallationSource()

একটি enum মান প্রদান করে যা নির্দেশ করে যে স্ক্রিপ্টটি বর্তমান ব্যবহারকারীর জন্য অ্যাড-অন হিসাবে কীভাবে ইনস্টল করা হয়েছে (উদাহরণস্বরূপ, ব্যবহারকারী এটি Chrome ওয়েব স্টোরের মাধ্যমে ব্যক্তিগতভাবে ইনস্টল করেছেন কিনা, বা একজন ডোমেন প্রশাসক এটি সমস্ত ব্যবহারকারীর জন্য ইনস্টল করেছেন কিনা)৷

প্রত্যাবর্তন

InstallationSource — ইনস্টলেশনের উৎস।


getOAuthToken()

কার্যকর ব্যবহারকারীর জন্য OAuth 2.0 অ্যাক্সেস টোকেন পায়। যদি স্ক্রিপ্টের OAuth স্কোপগুলি অন্য Google API-কে অনুমোদন করার জন্য যথেষ্ট হয় যার জন্য সাধারণত নিজস্ব OAuth প্রবাহের প্রয়োজন হয় (যেমন Google পিকার ), স্ক্রিপ্টগুলি পরিবর্তে এই টোকেনটি পাস করে দ্বিতীয় অনুমোদনের প্রম্পটটিকে বাইপাস করতে পারে৷ টোকেন একটি সময় পরে মেয়াদ শেষ হয় (ন্যূনতম কয়েক মিনিট); স্ক্রিপ্টগুলি অনুমোদনের ব্যর্থতাগুলি পরিচালনা করবে এবং প্রয়োজনে একটি নতুন টোকেন পেতে এই পদ্ধতিটিকে কল করবে।

এই পদ্ধতি দ্বারা প্রত্যাবর্তিত টোকেন শুধুমাত্র স্ক্রিপ্টের বর্তমানে প্রয়োজন এমন সুযোগগুলি অন্তর্ভুক্ত করে। যে স্কোপগুলি আগে অনুমোদিত ছিল কিন্তু স্ক্রিপ্ট দ্বারা আর ব্যবহার করা হয় না সেগুলি প্রত্যাবর্তিত টোকেনে অন্তর্ভুক্ত নয়৷ যদি অতিরিক্ত OAuth স্কোপের প্রয়োজন হয় স্ক্রিপ্টের নিজের প্রয়োজনের বাইরে, সেগুলি স্ক্রিপ্টের ম্যানিফেস্ট ফাইলে নির্দিষ্ট করা যেতে পারে।

প্রত্যাবর্তন

String — OAuth 2.0 টোকেনের একটি স্ট্রিং উপস্থাপনা।


getProjectTriggers()

বর্তমান প্রকল্প এবং বর্তমান ব্যবহারকারীর সাথে যুক্ত সমস্ত ইনস্টলযোগ্য ট্রিগার পায়।

Logger.log('Current project has ' + ScriptApp.getProjectTriggers().length + ' triggers.');

প্রত্যাবর্তন

Trigger[] — এই প্রকল্পের সাথে যুক্ত বর্তমান ব্যবহারকারীর ট্রিগারগুলির একটি অ্যারে।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

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

getScriptId()

স্ক্রিপ্ট প্রকল্পের অনন্য আইডি পায়। getProjectKey() এর বিপরীতে স্ক্রিপ্ট প্রকল্পের জন্য অনন্য শনাক্তকারী পেতে এটি পছন্দের পদ্ধতি। এই আইডিটি এমন সমস্ত জায়গায় ব্যবহার করা যেতে পারে যেখানে প্রকল্প কী আগে দেওয়া হয়েছিল।

প্রত্যাবর্তন

String - স্ক্রিপ্ট প্রকল্পের আইডি।


getService()

একটি ওয়েব অ্যাপ হিসাবে স্ক্রিপ্ট প্রকাশ নিয়ন্ত্রণ করতে ব্যবহৃত একটি বস্তু পায়।

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

প্রত্যাবর্তন

Service - একটি ওয়েব অ্যাপ হিসাবে স্ক্রিপ্ট প্রকাশ করা পর্যবেক্ষণ এবং নিয়ন্ত্রণ করতে ব্যবহৃত একটি বস্তু।


getUserTriggers(document)

এই স্ক্রিপ্ট বা অ্যাড-অনের জন্য প্রদত্ত নথিতে এই ব্যবহারকারীর মালিকানাধীন সমস্ত ইনস্টলযোগ্য ট্রিগার পায়৷ অন্যান্য স্ক্রিপ্টের সাথে সংযুক্ত ট্রিগারগুলি দেখতে এই পদ্ধতিটি ব্যবহার করা যাবে না।

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

পরামিতি

নাম টাইপ বর্ণনা
document Document একটি Google ডক্স ফাইল যাতে ইনস্টলযোগ্য ট্রিগার থাকতে পারে।

প্রত্যাবর্তন

Trigger[] — প্রদত্ত নথিতে এই ব্যবহারকারীর মালিকানাধীন ট্রিগারগুলির একটি অ্যারে।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

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

getUserTriggers(form)

এই স্ক্রিপ্ট বা অ্যাড-অনের জন্য প্রদত্ত ফর্মে এই ব্যবহারকারীর মালিকানাধীন সমস্ত ইনস্টলযোগ্য ট্রিগার পায়৷ অন্যান্য স্ক্রিপ্টের সাথে সংযুক্ত ট্রিগারগুলি দেখতে এই পদ্ধতিটি ব্যবহার করা যাবে না।

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

পরামিতি

নাম টাইপ বর্ণনা
form Form একটি Google ফর্ম ফাইল যাতে ইনস্টলযোগ্য ট্রিগার থাকতে পারে।

প্রত্যাবর্তন

Trigger[] — প্রদত্ত ফর্মে এই ব্যবহারকারীর মালিকানাধীন ট্রিগারগুলির একটি অ্যারে।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

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

getUserTriggers(spreadsheet)

প্রদত্ত স্প্রেডশীটে এই ব্যবহারকারীর মালিকানাধীন সমস্ত ইনস্টলযোগ্য ট্রিগার পায়, শুধুমাত্র এই স্ক্রিপ্ট বা অ্যাড-অনের জন্য। অন্যান্য স্ক্রিপ্টের সাথে সংযুক্ত ট্রিগারগুলি দেখতে এই পদ্ধতিটি ব্যবহার করা যাবে না।

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

পরামিতি

নাম টাইপ বর্ণনা
spreadsheet Spreadsheet একটি Google পত্রক ফাইল যাতে ইনস্টলযোগ্য ট্রিগার থাকতে পারে।

প্রত্যাবর্তন

Trigger[] — প্রদত্ত স্প্রেডশীটে এই ব্যবহারকারীর মালিকানাধীন ট্রিগারগুলির একটি অ্যারে।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

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

invalidateAuth()

বর্তমান স্ক্রিপ্টটি কার্যকর করার জন্য কার্যকর ব্যবহারকারীর অনুমোদন বাতিল করে। বর্তমান স্ক্রিপ্টের জন্য কোনো অনুমতি বাতিল করতে ব্যবহৃত হয়। এটি এক-শট অনুমোদন হিসাবে ট্যাগ করা ফাংশনগুলির জন্য বিশেষভাবে কার্যকর। যেহেতু ওয়ান-শট অনুমোদন ফাংশনগুলিকে স্ক্রিপ্টটি অনুমোদন পাওয়ার পরে শুধুমাত্র প্রথম রান বলা যেতে পারে, আপনি যদি পরে একটি ক্রিয়া সম্পাদন করতে চান, তাহলে আপনাকে অবশ্যই স্ক্রিপ্টের যেকোনো অনুমোদন প্রত্যাহার করতে হবে, যাতে ব্যবহারকারী আবার অনুমোদন ডায়ালগ দেখতে পারেন৷

ScriptApp.invalidateAuth();

নিক্ষেপ করে

Error — যখন অবৈধকরণ ব্যর্থ হয়


newStateToken()

একটি কলব্যাক API (যেমন একটি 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.
  var scriptUrl = 'https://script.google.com/macros/d/1234567890abcdefghijklmonpqrstuvwxyz';
  var urlSuffix = '/usercallback?state=';
  var stateToken = ScriptApp.newStateToken()
      .withMethod(callbackFunction)
      .withTimeout(120)
      .createToken();
  return scriptUrl + urlSuffix + stateToken;
}

বেশিরভাগ OAuth2 ফ্লোতে, state টোকেন সরাসরি অনুমোদনের এন্ডপয়েন্টে পাঠানো হয় (কলব্যাক ইউআরএলের অংশ হিসেবে নয়), এবং অনুমোদনের শেষ পয়েন্ট এটিকে কলব্যাক ইউআরএলের অংশ হিসেবে পাস করে।

যেমন:

  • স্ক্রিপ্টটি ব্যবহারকারীকে OAuth2 অনুমোদনের URL-এ পুনঃনির্দেশ করে: 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 — রাষ্ট্র-টোকেন-বিল্ডিং প্রক্রিয়া চালিয়ে যেতে ব্যবহৃত একটি বস্তু।


newTrigger(functionName)

একটি ইনস্টলযোগ্য ট্রিগার তৈরি করার প্রক্রিয়া শুরু করে যেটি, যখন বহিস্কার করা হয়, একটি প্রদত্ত ফাংশনকে কল করে।

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

পরামিতি

নাম টাইপ বর্ণনা
functionName String ট্রিগার ফায়ার হলে কল করার ফাংশন। আপনি অন্তর্ভুক্ত লাইব্রেরি থেকে ফাংশন ব্যবহার করতে পারেন, যেমন Library.libFunction1

প্রত্যাবর্তন

TriggerBuilder - ট্রিগার-বিল্ডিং প্রক্রিয়া চালিয়ে যাওয়ার জন্য ব্যবহৃত একটি বস্তু।

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

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

অপ্রচলিত পদ্ধতি