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