Google Apps Script API আপনাকে আপনার অ্যাক্সেস থাকা একটি স্ক্রিপ্ট প্রকল্পে দূরবর্তীভাবে একটি ফাংশন কার্যকর করতে দেয়। আপনার অ্যাপ একটি নির্দিষ্ট Apps Script ফাংশন কল করতে পারে, প্রয়োজনে এটিকে ইনপুট প্যারামিটার প্রদান করতে পারে এবং একটি প্রতিক্রিয়া পেতে পারে।
এই পৃষ্ঠার উদাহরণগুলি API ব্যবহার করে কীভাবে সাধারণ এক্সিকিউশন অপারেশনগুলি অর্জন করা যেতে পারে তা ব্যাখ্যা করে। বিশেষ অনুমোদনের প্রয়োজনীয়তা সহ আরও তথ্যের জন্য, একটি ফাংশন এক্সিকিউট করুন নির্দেশিকা দেখুন।
এই উদাহরণগুলিতে, স্ক্রিপ্ট প্রকল্প আইডি কোথায় প্রদান করবেন তা নির্দেশ করার জন্য প্লেসহোল্ডার scriptId ব্যবহার করা হয়। স্ক্রিপ্ট আইডি খুঁজে পেতে নীচের পদক্ষেপগুলি অনুসরণ করুন:
- অ্যাপস স্ক্রিপ্ট প্রজেক্টে, উপরের বাম দিকে, প্রজেক্ট সেটিংস ক্লিক করুন।
- "স্ক্রিপ্ট আইডি" এর পাশে, কপি করুন এ ক্লিক করুন।
একটি ফাংশন কার্যকর করুন
নিম্নলিখিত scripts.run অনুরোধটি listFolderContent নামে একটি Apps Script ফাংশন কল করে, এটিকে Google Drive folderId এবং একটি পূর্ণসংখ্যা MAX_SIZE আর্গুমেন্ট হিসেবে পাস করে। ফাংশনটি ডেভেলপমেন্ট মোডে কার্যকর করা হয়, যার অর্থ হল ফাংশনের সাম্প্রতিক সংরক্ষিত সংস্করণটি কার্যকর করা হয়, এক্সিকিউটেবল হিসাবে কোন সংস্করণ স্থাপন করা হয়েছে তা নির্বিশেষে।
অনুরোধ প্রোটোকলটি নীচে দেখানো হল। এক্সিকিউট ফাংশন নির্দেশিকাটি দেখায় যে গুগল এপিআই ক্লায়েন্ট লাইব্রেরি ব্যবহার করে বিভিন্ন ভাষায় রান অনুরোধ কীভাবে বাস্তবায়ন করা যায়।
POST https://script.googleapis.com/v1/scripts/scriptId:run
{
"function": "listFolderContent",
"parameters": [
folderId,
MAX_SIZE
],
"devMode": true
}এই অনুরোধের প্রতিক্রিয়া , একবার অ্যাপস স্ক্রিপ্ট ফাংশনটি সম্পূর্ণ হয়ে গেলে, কার্যকর করার ফলাফল বা একটি ত্রুটি প্রতিক্রিয়া ধারণ করে। এই উদাহরণে, ফাংশনটি সফলভাবে ফাইলের নামের একটি অ্যারে ফেরত দেয়:
{
"response": {
"result": [
"fileTitle1",
"fileTitle2",
"fileTitle3"
]
},
}যদি অ্যাপস স্ক্রিপ্ট কার্যকর করার সময় ফাংশনটি কোনও ত্রুটির সম্মুখীন হয়, তাহলে প্রতিক্রিয়াটি এইরকম দেখাতে পারে:
{ "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 }] }] } } }