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