অ্যাপস স্ক্রিপ্ট এপিআই (এবং পূর্বে অ্যাপস স্ক্রিপ্ট এক্সিকিউশন এপিআই) আপনাকে আপনার অ্যাক্সেস থাকা স্ক্রিপ্ট প্রজেক্টে দূরবর্তীভাবে একটি ফাংশন কার্যকর করতে দেয়। আপনার অ্যাপটি একটি নির্দিষ্ট অ্যাপস স্ক্রিপ্ট ফাংশন কল করতে পারে, প্রয়োজনে এটিকে ইনপুট প্যারামিটার প্রদান করতে পারে এবং একটি ফেরত প্রতিক্রিয়া পেতে পারে।
এই পৃষ্ঠার উদাহরণগুলি API ব্যবহার করে কীভাবে কিছু সাধারণ এক্সিকিউশন অপারেশন অর্জন করা যেতে পারে তা ব্যাখ্যা করে। বিশেষ অনুমোদনের প্রয়োজনীয়তা সহ আরও তথ্যের জন্য, একটি ফাংশন এক্সিকিউটিং গাইড দেখুন।
এই উদাহরণগুলিতে, স্ক্রিপ্ট প্রকল্প আইডি কোথায় প্রদান করবেন তা নির্দেশ করার জন্য প্লেসহোল্ডার scriptId ব্যবহার করা হয়। স্ক্রিপ্ট আইডি খুঁজে পেতে নীচের পদক্ষেপগুলি অনুসরণ করুন:
- অ্যাপস স্ক্রিপ্ট প্রজেক্টে, উপরের বাম দিকে, প্রজেক্ট সেটিংস ক্লিক করুন।
- "স্ক্রিপ্ট আইডি" এর পাশে, কপি করুন এ ক্লিক করুন।
একটি ফাংশন কার্যকর করুন
নিম্নলিখিত scripts.run অনুরোধটি listFolderContent নামে একটি Apps Script ফাংশন কল করে, এটিকে 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 }] }] } } }