এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

HTML পরিষেবা: সার্ভার ফাংশনের সাথে যোগাযোগ করুন

google.script.run হল একটি অ্যাসিঙ্ক্রোনাস ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট API যা HTML-পরিষেবা পৃষ্ঠাগুলিকে সার্ভার-সাইড অ্যাপস স্ক্রিপ্ট ফাংশন কল করার অনুমতি দেয়। নিম্নলিখিত উদাহরণটি google.script.run এর সবচেয়ে মৌলিক কার্যকারিতা দেখায় — ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট থেকে সার্ভারে একটি ফাংশন কল করা ।

কোড.জিএস

function doGet() {
  return HtmlService.createHtmlOutputFromFile('Index');
}

function doSomething() {
  Logger.log('I was called!');
}

ইনডেক্স.এইচটিএমএল

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <script>
      google.script.run.doSomething();
    </script>
  </head>
</html>

আপনি যদি এই স্ক্রিপ্টটি একটি ওয়েব অ্যাপ হিসেবে স্থাপন করেন এবং এর URL টি দেখেন, তাহলে আপনি কিছুই দেখতে পাবেন না, কিন্তু যদি আপনি লগগুলি দেখেন, তাহলে আপনি দেখতে পাবেন যে সার্ভার ফাংশন doSomething কল করা হয়েছে।

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

google.script.run API সার্ভার ফাংশনে ১০টি একযোগে কল করার অনুমতি দেয়। ১০টি চলমান থাকাকালীন আপনি যদি ১১তম কল করেন, তাহলে সার্ভার ফাংশনটি ১০টি স্পটের মধ্যে একটি খালি না হওয়া পর্যন্ত বিলম্বিত হবে। বাস্তবে, আপনার খুব কমই এই সীমাবদ্ধতা সম্পর্কে চিন্তা করা উচিত, বিশেষ করে যেহেতু বেশিরভাগ ব্রাউজার ইতিমধ্যেই একই সার্ভারে একযোগে অনুরোধের সংখ্যা ১০-এর কম সংখ্যায় সীমাবদ্ধ করে। উদাহরণস্বরূপ, Firefox-এ সীমা ৬। বেশিরভাগ ব্রাউজার একইভাবে অতিরিক্ত সার্ভার অনুরোধ বিলম্বিত করে যতক্ষণ না বিদ্যমান অনুরোধগুলির মধ্যে একটি সম্পূর্ণ হয়।

প্যারামিটার এবং রিটার্ন মান

ক্লায়েন্টের প্যারামিটার সহ একটি সার্ভার ফাংশন কল করুন। একইভাবে, একটি সার্ভার ফাংশন ক্লায়েন্টকে একটি মান ফেরত দিতে পারে যা একটি সফল হ্যান্ডলারে প্যারামিটার হিসাবে পাস করা হয়।

আইনি প্যারামিটার এবং রিটার্ন মান হল জাভাস্ক্রিপ্ট প্রিমিটিভ যেমন Number , Boolean , String , অথবা null , এবং জাভাস্ক্রিপ্ট অবজেক্ট এবং অ্যারে যা প্রিমিটিভ, অবজেক্ট এবং অ্যারে দিয়ে গঠিত। পৃষ্ঠার মধ্যে একটি form উপাদান প্যারামিটার হিসাবেও বৈধ, তবে এটি অবশ্যই ফাংশনের একমাত্র প্যারামিটার হতে হবে এবং এটি রিটার্ন মান হিসাবে বৈধ নয়। যদি আপনি একটি form ছাড়াও একটি Date , Function , DOM উপাদান, অথবা অন্যান্য নিষিদ্ধ প্রকার, যার মধ্যে অবজেক্ট বা অ্যারের ভিতরে নিষিদ্ধ প্রকার অন্তর্ভুক্ত, পাস করার চেষ্টা করেন তবে অনুরোধগুলি ব্যর্থ হয়। যে বস্তুগুলি বৃত্তাকার রেফারেন্স তৈরি করে সেগুলিও ব্যর্থ হয় এবং অ্যারের মধ্যে অনির্ধারিত ক্ষেত্রগুলি null হয়ে যায়।

মনে রাখবেন যে সার্ভারে পাঠানো একটি বস্তু মূল বস্তুর একটি অনুলিপি হয়ে যায়। যদি একটি সার্ভার ফাংশন একটি বস্তু গ্রহণ করে এবং তার বৈশিষ্ট্য পরিবর্তন করে, তাহলে ক্লায়েন্টের বৈশিষ্ট্যগুলি প্রভাবিত হয় না।

সাফল্য হ্যান্ডলার

যেহেতু google.script.run কলগুলি অ্যাসিঙ্ক্রোনাস, ক্লায়েন্ট-সাইড কোড কোনও প্রতিক্রিয়ার জন্য অপেক্ষা না করেই পরবর্তী লাইনে চলতে থাকে। সার্ভার প্রতিক্রিয়া জানালে যে কলব্যাক ফাংশনটি চলে তা নির্দিষ্ট করতে, withSuccessHandler(function) ব্যবহার করুন। যদি সার্ভার ফাংশন কোনও মান ফেরত দেয়, তাহলে API সেই মানটি কলব্যাক ফাংশনে একটি প্যারামিটার হিসাবে পাস করে।

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

কোড.জিএস

function doGet() {
  return HtmlService.createHtmlOutputFromFile('Index');
}

function getUnreadEmails() {
  return GmailApp.getInboxUnreadCount();
}

ইনডেক্স.এইচটিএমএল

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <script>
      function onSuccess(numUnread) {
        var div = document.getElementById('output');
        div.innerHTML = 'You have ' + numUnread
            + ' unread messages in your Gmail inbox.';
      }

      google.script.run.withSuccessHandler(onSuccess)
          .getUnreadEmails();
    </script>
  </head>
  <body>
    <div id="output"></div>
  </body>
</html>

ব্যর্থতা হ্যান্ডলার

যদি সার্ভার সাড়া দিতে ব্যর্থ হয় অথবা কোনও ত্রুটি ঠেলে দেয়, তাহলে withFailureHandler(function) আপনাকে একটি সফল হ্যান্ডলারের পরিবর্তে চালানোর জন্য একটি ব্যর্থতা হ্যান্ডলার নির্দিষ্ট করতে দেয়। যদি কোনও ত্রুটি দেখা দেয়, তাহলে API Error বস্তুটিকে ব্যর্থতা হ্যান্ডলারের কাছে একটি আর্গুমেন্ট হিসাবে প্রেরণ করে।

ডিফল্টরূপে, যদি আপনি একটি ব্যর্থতা হ্যান্ডলার নির্দিষ্ট না করেন, তাহলে ব্যর্থতাগুলি জাভাস্ক্রিপ্ট কনসোলে লগ করা হয়। এটিকে ওভাররাইড করতে, withFailureHandler(null) কল করুন অথবা এমন একটি ব্যর্থতা হ্যান্ডলার সরবরাহ করুন যা কিছুই করে না।

এই উদাহরণে দেখানো হয়েছে যে, ব্যর্থতা হ্যান্ডলারের সিনট্যাক্স প্রায় সাফল্য হ্যান্ডলারের মতোই।

কোড.জিএস

function doGet() {
  return HtmlService.createHtmlOutputFromFile('Index');
}

function getUnreadEmails() {
  // 'got' instead of 'get' throws an error.
  return GmailApp.gotInboxUnreadCount();
}

ইনডেক্স.এইচটিএমএল

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <script>
      function onFailure(error) {
        var div = document.getElementById('output');
        div.innerHTML = "ERROR: " + error.message;
      }

      google.script.run.withFailureHandler(onFailure)
          .getUnreadEmails();
    </script>
  </head>
  <body>
    <div id="output"></div>
  </body>
</html>

ব্যবহারকারীর বস্তু

সার্ভারে একাধিক কলের জন্য একই সাফল্য বা ব্যর্থতা হ্যান্ডলার পুনরায় ব্যবহার করতে, withUserObject(object) কল করুন এবং দ্বিতীয় প্যারামিটার হিসেবে হ্যান্ডলারে পাঠানো একটি অবজেক্ট নির্দিষ্ট করুন। এই "user object", যা User ক্লাসের সাথে বিভ্রান্ত না করে, আপনাকে ক্লায়েন্ট সার্ভারের সাথে যে প্রসঙ্গে যোগাযোগ করেছে তার প্রতিক্রিয়া জানাতে দেয়। যেহেতু ব্যবহারকারীর অবজেক্টগুলি সার্ভারে পাঠানো হয় না, তাই এগুলি বেশিরভাগ জিনিস হতে পারে, যার মধ্যে ফাংশন এবং DOM উপাদান অন্তর্ভুক্ত, সার্ভার কলের জন্য প্যারামিটার এবং রিটার্ন মানের উপর কোনও বিধিনিষেধ ছাড়াই। ব্যবহারকারীর অবজেক্টগুলি new অপারেটর দিয়ে তৈরি অবজেক্ট হতে পারে না।

এই উদাহরণে, দুটি বোতামের যেকোনো একটিতে ক্লিক করলে সার্ভার থেকে একটি মান সহ বোতামটি আপডেট হয় এবং অন্য বোতামটি অপরিবর্তিত থাকে, যদিও তারা একটি সাফল্য হ্যান্ডলার ভাগ করে নেয়। onclick হ্যান্ডলারের ভিতরে, this কীওয়ার্ডটি button নির্দেশ করে।

কোড.জিএস

function doGet() {
  return HtmlService.createHtmlOutputFromFile('Index');
}

function getEmail() {
  return Session.getActiveUser().getEmail();
}

ইনডেক্স.এইচটিএমএল

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <script>
      function updateButton(email, button) {
        button.value = 'Clicked by ' + email;
      }
    </script>
  </head>
  <body>
    <input type="button" value="Not Clicked"
      onclick="google.script.run
          .withSuccessHandler(updateButton)
          .withUserObject(this)
          .getEmail()" />
    <input type="button" value="Not Clicked"
      onclick="google.script.run
          .withSuccessHandler(updateButton)
          .withUserObject(this)
          .getEmail()" />
  </body>
</html>

ফর্ম

যদি আপনি একটি সার্ভার ফাংশনকে একটি form এলিমেন্টকে প্যারামিটার হিসেবে কল করেন, তাহলে ফর্মটি একটি একক অবজেক্টে পরিণত হয় যেখানে ফিল্ডের নাম কী এবং ফিল্ডের মান মান হিসেবে থাকে। ফাইল-ইনপুট ফিল্ডের বিষয়বস্তু ছাড়া, যা Blob অবজেক্টে পরিণত হয়, সমস্ত মান স্ট্রিংয়ে রূপান্তরিত হয়।

এই উদাহরণটি পৃষ্ঠাটি পুনরায় লোড না করেই একটি ফর্ম প্রক্রিয়া করে, যার মধ্যে একটি ফাইল-ইনপুট ফিল্ডও রয়েছে; এটি ফাইলটি Google ড্রাইভে আপলোড করে এবং তারপর ক্লায়েন্ট-সাইড পৃষ্ঠায় ফাইলের URL প্রিন্ট করে। onsubmit হ্যান্ডলারের ভিতরে, this কীওয়ার্ডটি ফর্মটিকেই নির্দেশ করে। মনে রাখবেন যে পৃষ্ঠায় সমস্ত ফর্ম লোড করার সময় preventFormSubmit দ্বারা ডিফল্ট জমা দেওয়ার ক্রিয়াটি অক্ষম করা থাকে। এটি ব্যতিক্রমের ক্ষেত্রে পৃষ্ঠাটিকে একটি ভুল URL-এ পুনঃনির্দেশিত হতে বাধা দেয়।

কোড.জিএস

function doGet() {
  return HtmlService.createHtmlOutputFromFile('Index');
}

function processForm(formObject) {
  var formBlob = formObject.myFile;
  var driveFile = DriveApp.createFile(formBlob);
  return driveFile.getUrl();
}

ইনডেক্স.এইচটিএমএল

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <script>
      // Prevent forms from submitting.
      function preventFormSubmit() {
        var forms = document.querySelectorAll('form');
        for (var i = 0; i < forms.length; i++) {
          forms[i].addEventListener('submit', function(event) {
            event.preventDefault();
          });
        }
      }
      window.addEventListener('load', preventFormSubmit);

      function handleFormSubmit(formObject) {
        google.script.run.withSuccessHandler(updateUrl).processForm(formObject);
      }
      function updateUrl(url) {
        var div = document.getElementById('output');
        div.innerHTML = '<a href="' + url + '">Got it!</a>';
      }
    </script>
  </head>
  <body>
    <form id="myForm" onsubmit="handleFormSubmit(this)">
      <input name="myFile" type="file" />
      <input type="submit" value="Submit" />
    </form>
    <div id="output"></div>
 </body>
</html>

স্ক্রিপ্ট রানার

google.script.run কে "স্ক্রিপ্ট রানার" এর নির্মাতা হিসেবে ভাবুন। আপনি যদি একটি স্ক্রিপ্ট রানারে একটি সাফল্য হ্যান্ডলার, ব্যর্থতা হ্যান্ডলার, অথবা ব্যবহারকারীর বস্তু যোগ করেন, তাহলে আপনি বিদ্যমান রানারটি পরিবর্তন করছেন না; পরিবর্তে, আপনি নতুন আচরণ সহ একটি নতুন স্ক্রিপ্ট রানার ফিরে পাবেন।

withSuccessHandler , withFailureHandler , এবং withUserObject এর যেকোনো সমন্বয় এবং যেকোনো ক্রম ব্যবহার করুন। এছাড়াও, এমন যেকোনো স্ক্রিপ্ট রানারের পরিবর্তনকারী ফাংশন কল করুন যার ইতিমধ্যেই একটি মান সেট রয়েছে। নতুন মানটি পূর্ববর্তী মানকে ওভাররাইড করে।

এই উদাহরণে তিনটি সার্ভার কলের জন্য একটি সাধারণ ব্যর্থতা হ্যান্ডলার সেট করা হয়েছে, তবে দুটি পৃথক সাফল্য হ্যান্ডলার রয়েছে:

var myRunner = google.script.run.withFailureHandler(onFailure);
var myRunner1 = myRunner.withSuccessHandler(onSuccess);
var myRunner2 = myRunner.withSuccessHandler(onDifferentSuccess);

myRunner1.doSomething();
myRunner1.doSomethingElse();
myRunner2.doSomething();

ব্যক্তিগত ফাংশন

যেসব সার্ভার ফাংশনের নাম আন্ডারস্কোর দিয়ে শেষ হয়, সেগুলোকে প্রাইভেট হিসেবে বিবেচনা করা হয়। google.script এই ফাংশনগুলিকে কল করতে পারে না এবং তাদের নাম কখনই ক্লায়েন্টের কাছে পাঠানো হয় না। সার্ভারে গোপন রাখতে হবে এমন বাস্তবায়নের বিবরণ লুকানোর জন্য আপনি এগুলি ব্যবহার করতে পারেন। google.script লাইব্রেরির মধ্যে ফাংশন বা স্ক্রিপ্টের শীর্ষ স্তরে ঘোষিত না হওয়া ফাংশনগুলিও দেখতে পারে না।

এই উদাহরণে, ক্লায়েন্ট কোডে getBankBalance ফাংশনটি উপলব্ধ; যে ব্যবহারকারী আপনার সোর্স কোডটি পরীক্ষা করে, আপনি এটি কল না করলেও এর নামটি আবিষ্কার করতে পারে। তবে, deepSecret_ এবং obj.objectMethod ফাংশনগুলি ক্লায়েন্টের কাছে সম্পূর্ণ অদৃশ্য।

কোড.জিএস

function doGet() {
  return HtmlService.createHtmlOutputFromFile('Index');
}

function getBankBalance() {
  var email = Session.getActiveUser().getEmail()
  return deepSecret_(email);
}

function deepSecret_(email) {
 // Do some secret calculations
 return email + ' has $1,000,000 in the bank.';
}

var obj = {
  objectMethod: function() {
    // More secret calculations
  }
};

ইনডেক্স.এইচটিএমএল

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <script>
      function onSuccess(balance) {
        var div = document.getElementById('output');
        div.innerHTML = balance;
      }

      google.script.run.withSuccessHandler(onSuccess)
          .getBankBalance();
    </script>
  </head>
  <body>
    <div id="output">No result yet...</div>
  </body>
</html>

Google Workspace অ্যাপ্লিকেশনে ডায়ালগের আকার পরিবর্তন করুন

Google Docs, Google Sheets, অথবা Forms-এ কাস্টম ডায়ালগ বক্সগুলিকে ক্লায়েন্ট-সাইড কোডে google.script.host পদ্ধতি setWidth(width) অথবা setHeight(height) কল করে পুনরায় আকার দেওয়া যেতে পারে। (একটি ডায়ালগের প্রাথমিক আকার সেট করতে, HtmlOutput পদ্ধতি setWidth(width) এবং setHeight(height) ব্যবহার করুন।) মনে রাখবেন যে আকার পরিবর্তন করার সময় ডায়ালগগুলি প্যারেন্ট উইন্ডোতে পুনরায় কেন্দ্রীভূত হয় না এবং সাইডবারগুলি পুনরায় আকার দেওয়া সম্ভব নয়।

Google Workspace-এ ডায়ালগ এবং সাইডবার বন্ধ করুন

যদি আপনি Google Docs, Sheets, অথবা Forms-এ কোনও ডায়ালগ বা সাইডবার প্রদর্শনের জন্য HTML পরিষেবা ব্যবহার করেন, তাহলে window.close কল করে ইন্টারফেসটি বন্ধ করতে পারবেন না। পরিবর্তে, আপনাকে google.script.host.close কল করতে হবে। উদাহরণস্বরূপ, Google Workspace ব্যবহারকারী ইন্টারফেস হিসাবে HTML পরিবেশন করার বিভাগটি দেখুন।

Google Workspace-এ ব্রাউজারের ফোকাস সরান

ব্যবহারকারীর ব্রাউজারে ফোকাসকে একটি ডায়ালগ বা সাইডবার থেকে Google Docs, Sheets, অথবা Forms এডিটরে ফিরিয়ে আনতে, google.script.host.editor.focus পদ্ধতিটি কল করুন। এই পদ্ধতিটি বিশেষ করে Document.setCursor(position) এবং Document.setSelection(range) ডকুমেন্ট পরিষেবা পদ্ধতির সাথে একত্রে কার্যকর।