প্রকল্পগুলি পরিচালনা করুন

এই বিভাগে গুগল অ্যাপস স্ক্রিপ্ট এপিআই-এর সেইসব মেথডগুলোর একটি সংক্ষিপ্ত বিবরণ দেওয়া হয়েছে, যা ব্যবহার করে আপনি আপনার গুগল অ্যাপস স্ক্রিপ্ট প্রজেক্ট তৈরি, পড়া, পরিবর্তন এবং মনিটর করতে পারেন। ‘প্রজেক্ট ম্যানেজমেন্ট স্যাম্পলস’ পেজটিতে এপিআই ম্যানেজমেন্ট রিকোয়েস্টের উদাহরণ দেখানো হয়েছে। প্রতিটি মেথডের রেফারেন্স ডকুমেন্টেশনে এর বাস্তবায়নের বিস্তারিত বিবরণ দেওয়া আছে।

এপিআই পদ্ধতির সংক্ষিপ্ত বিবরণ
প্রকল্প তৈরি করুন	প্রকল্প তৈরি করুন ফলাফল : কোনো প্রজেক্ট ফাইল ছাড়া এবং একটি ডিফল্ট প্রজেক্ট ম্যানিফেস্ট সহ একটি মৌলিক, খালি প্রজেক্ট তৈরি করুন। বিকল্পসমূহ : আপনি একটি প্রজেক্টের শিরোনাম দিতে পারেন। এছাড়াও, স্ক্রিপ্টটির প্যারেন্ট হিসেবে কাজ করার জন্য আপনি কোনো Google Docs, Google Sheets, Google Forms, বা Google Slides ফাইলের Google Drive ID দিয়ে একটি বাউন্ড স্ক্রিপ্ট তৈরি করতে পারেন।
প্রকল্পের মেটাডেটা পড়ুন	প্রকল্পগুলি.পেতে ফলাফল : একটি Project অবজেক্ট পুনরুদ্ধার করে, যা প্রজেক্টের মেটাডেটা উপস্থাপন করে। এই ডেটার মধ্যে প্রজেক্টের শিরোনাম, স্ক্রিপ্ট আইডি, সৃষ্টিকারী ব্যবহারকারী, তৈরির সময় এবং অন্যান্য বিবরণ অন্তর্ভুক্ত থাকে।
প্রকল্পের বিষয়বস্তু পড়ুন	প্রকল্পসমূহ. বিষয়বস্তু পান ফলাফল : প্রজেক্টের প্রতিটি কোড এবং HTML ফাইলের জন্য একটি করে File অবজেক্টের একটি অ্যারে রিটার্ন করে। এই তালিকায় একটি JSON ফাইল হিসেবে প্রজেক্ট ম্যানিফেস্টও অন্তর্ভুক্ত থাকে। File অবজেক্টগুলোতে ফাইলের সোর্স কন্টেন্ট ( File.source ) এবং অন্যান্য মেটাডেটা, যেমন ফাইলের ফাংশনগুলোর তালিকা ( File.functionSet ) থাকে। বিকল্প : আপনি একটি কোয়েরি প্যারামিটারের মাধ্যমে কন্টেন্টের কোন সংস্করণটি পুনরুদ্ধার করতে চান তা নির্দিষ্ট করতে পারেন।
প্রকল্পের বিষয়বস্তু আপডেট করুন	প্রকল্পসমূহ.আপডেটকন্টেন্ট ফলাফল : একটি স্ক্রিপ্ট প্রজেক্টের ফাইলের বিষয়বস্তু পরিবর্তন করে। আপনি নতুন বিষয়বস্তুটি File অবজেক্টের একটি অ্যারে হিসেবে প্রদান করেন। এই File অবজেক্টগুলোর মধ্যে একটির টাইপ অবশ্যই JSON হতে হবে এবং এটি স্ক্রিপ্ট প্রজেক্টের নতুন প্রজেক্ট ম্যানিফেস্টকে প্রতিনিধিত্ব করবে। নতুন বিষয়বস্তুটি প্রজেক্টের HEAD সংস্করণ হিসেবে সংরক্ষিত হয়। এটি তখন ব্যবহৃত হয় যখন স্ক্রিপ্টটি ট্রিগার হিসেবে, স্ক্রিপ্ট এডিটরে, গুগল ওয়ার্কস্পেস অ্যাড-অন প্রিভিউ মোডে, অথবা ডেভেলপমেন্ট মোডে একটি ওয়েব অ্যাপ বা অ্যাপস স্ক্রিপ্ট এপিআই হিসেবে এক্সিকিউট হয়। দ্রষ্টব্য : স্ক্রিপ্ট প্রজেক্টের কন্টেন্ট আপডেট করতে, প্রথমে বিদ্যমান File একটি অ্যারে পাওয়ার জন্য একটি projects.getContent রিকোয়েস্ট পাঠান, সেই অবজেক্টগুলোতে প্রয়োজনীয় পরিবর্তনগুলো করুন, তারপর projects.updateContent রিকোয়েস্টের ইনপুট হিসেবে File ব্যবহার করুন। সতর্কীকরণ: নতুন কন্টেন্টটি স্ক্রিপ্ট প্রজেক্টের সমস্ত বিদ্যমান ফাইল প্রতিস্থাপন করবে। অনুরোধ দ্বারা আপডেট না হওয়া ফাইলগুলি মুছে ফেলা হবে।
প্রকল্পের মেট্রিক্স পড়ুন	projects.getMetrics ফলাফল : একটি প্রজেক্ট সম্পর্কিত নির্দিষ্ট মেট্রিকগুলো পড়ুন। এই মেট্রিকগুলোর মধ্যে রয়েছে ব্যবহারকারীর সংখ্যা, মোট এক্সিকিউশনের সংখ্যা, মোট এক্সিকিউশন ত্রুটির সংখ্যা এবং অন্যান্য বিবরণ। আপনি যে তথ্য অনুরোধ করছেন তা নির্দিষ্ট করতে একটি মেট্রিকটাইপ (MetricType) ব্যবহার করুন। বিকল্পসমূহ : একটি MetricsFilter ব্যবহার করে ফলাফলকে নির্দিষ্ট ডেপ্লয়মেন্ট বা স্ক্রিপ্ট ফাংশনে সীমাবদ্ধ করুন। এছাড়াও আপনি একটি MetricsIntervalConfig ব্যবহার করে একটি নির্দিষ্ট মেট্রিক ব্যবধান নির্ধারণ করতে পারেন।