বৈশিষ্ট্য পরিষেবা

প্রোপার্টিজ সার্ভিসটি একটি স্ক্রিপ্ট, স্ক্রিপ্টের একজন ব্যবহারকারী, অথবা কোনো অ্যাড-অন ব্যবহৃত হয় এমন একটি ডকুমেন্টের জন্য নির্দিষ্ট কী-ভ্যালু পেয়ারে ডেটা সংরক্ষণ করে। এটি সাধারণত ডেভেলপার কনফিগারেশন বা ব্যবহারকারীর পছন্দসমূহ সংরক্ষণ করতে ব্যবহৃত হয়। প্রোপার্টিজগুলো কখনোই স্ক্রিপ্টগুলোর মধ্যে শেয়ার করা হয় না।

Properties পরিষেবার দৈনিক কোটা ও স্টোরেজ সীমা দেখতে, Google পরিষেবাগুলির জন্য কোটা দেখুন।

সম্পত্তির দোকানগুলির তুলনা

PropertiesService গ্লোবাল অবজেক্টটি তিনটি মেথড প্রদান করে, যার প্রত্যেকটি একটি অনুরূপ Properties অবজেক্ট রিটার্ন করে কিন্তু ভিন্ন ভিন্ন অ্যাক্সেস অধিকার সহ, যা নিম্নলিখিত টেবিলে দেখানো হয়েছে:

	স্ক্রিপ্ট বৈশিষ্ট্য	ব্যবহারকারীর বৈশিষ্ট্য	ডকুমেন্ট প্রোপার্টিজ
অ্যাক্সেস করার পদ্ধতি	getScriptProperties()	getUserProperties()	getDocumentProperties()
ডেটা শেয়ার করা হয়েছে	একটি স্ক্রিপ্ট, অ্যাড-অন বা ওয়েব অ্যাপের সকল ব্যবহারকারী	একটি স্ক্রিপ্ট, অ্যাড-অন বা ওয়েব অ্যাপের বর্তমান ব্যবহারকারী	খোলা ডকুমেন্টে একটি অ্যাড-অনের সকল ব্যবহারকারী
সাধারণত এর জন্য ব্যবহৃত হয়	অ্যাপ-ব্যাপী কনফিগারেশন ডেটা, যেমন ডেভেলপারের বাহ্যিক ডেটাবেসের জন্য ইউজারনেম এবং পাসওয়ার্ড।	ব্যবহারকারী-নির্দিষ্ট সেটিংস, যেমন মেট্রিক বা ইম্পেরিয়াল একক	ডকুমেন্ট-নির্দিষ্ট ডেটা, যেমন একটি এমবেডেড চার্টের সোর্স ইউআরএল

ডেটা ফর্ম্যাট

প্রোপার্টিজ সার্ভিস সমস্ত ডেটা কী-ভ্যালু পেয়ারে স্ট্রিং হিসেবে সংরক্ষণ করে। যেসব ডেটা টাইপ আগে থেকেই স্ট্রিং নয়, সেগুলোকে স্বয়ংক্রিয়ভাবে স্ট্রিং-এ রূপান্তর করা হয়; এর মধ্যে সংরক্ষিত অবজেক্টের অন্তর্ভুক্ত মেথডগুলোও রয়েছে।

ডেটা সংরক্ষণ করুন

একটিমাত্র মান সংরক্ষণ করতে, নিম্নলিখিত উদাহরণে দেখানো অনুযায়ী উপযুক্ত স্টোরের Properties.setProperty(key, value) মেথডটি কল করুন:

service/propertyService.gs

GitHub-এ দেখুন

try {
  // Set a property in each of the three property stores.
  const scriptProperties = PropertiesService.getScriptProperties();
  const userProperties = PropertiesService.getUserProperties();
  const documentProperties = PropertiesService.getDocumentProperties();

  scriptProperties.setProperty("SERVER_URL", "http://www.example.com/");
  userProperties.setProperty("DISPLAY_UNITS", "metric");
  documentProperties.setProperty(
    "SOURCE_DATA_ID",
    "1j3GgabZvXUF177W0Zs_2v--H6SPCQb4pmZ6HsTZYT5k",
  );
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with error %s", err.message);
}

একসাথে অনেক ডেটা সংরক্ষণ করতে, Properties.setProperties(properties) -এ কী-ভ্যালু পেয়ারের একটি ম্যাপ পাস করুন। প্যারামিটারে থাকা অবজেক্টের প্রতিটি কী-ভ্যালু পেয়ার একটি আলাদা প্রপার্টি হিসেবে সংরক্ষিত হয়:

service/propertyService.gs

GitHub-এ দেখুন

try {
  // Set multiple script properties in one call.
  const scriptProperties = PropertiesService.getScriptProperties();
  scriptProperties.setProperties({
    cow: "moo",
    sheep: "baa",
    chicken: "cluck",
  });
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with error %s", err.message);
}

তথ্য পড়ুন

পূর্বে সংরক্ষণ করা কোনো একটি একক মান পুনরুদ্ধার করতে, Properties.getProperty কল করুন:

service/propertyService.gs

GitHub-এ দেখুন

try {
  // Get the value for the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  const units = userProperties.getProperty("DISPLAY_UNITS");
  console.log("values of units %s", units);
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with error %s", err.message);
}

বর্তমান প্রপার্টি স্টোরে থাকা সমস্ত মান পুনরুদ্ধার করতে, Properties.getProperties কল করুন:

service/propertyService.gs

GitHub-এ দেখুন

try {
  // Get multiple script properties in one call, then log them all.
  const scriptProperties = PropertiesService.getScriptProperties();
  const data = scriptProperties.getProperties();
  for (const key in data) {
    console.log("Key: %s, Value: %s", key, data[key]);
  }
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with error %s", err.message);
}

ডেটা পরিবর্তন করুন

getProperty এবং getProperties মেথডগুলো সংরক্ষিত ডেটার একটি কপি রিটার্ন করে, কোনো লাইভ ভিউ নয়। তাই, রিটার্ন করা অবজেক্টটি পরিবর্তন করলে প্রপার্টি স্টোরের ভ্যালু আপডেট হয় না। স্টোরের ডেটা আপডেট করতে, এটি আবার সেভ করুন:

service/propertyService.gs

GitHub-এ দেখুন

try {
  // Change the unit type in the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  let units = userProperties.getProperty("DISPLAY_UNITS");
  units = "imperial"; // Only changes local value, not stored value.
  userProperties.setProperty("DISPLAY_UNITS", units); // Updates stored value.
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with error %s", err.message);
}

ডেটা মুছুন

একটিমাত্র মান মুছে ফেলার জন্য, Properties.deleteProperty কল করুন:

service/propertyService.gs

GitHub-এ দেখুন

try {
  // Delete the user property 'DISPLAY_UNITS'.
  const userProperties = PropertiesService.getUserProperties();
  userProperties.deleteProperty("DISPLAY_UNITS");
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with error %s", err.message);
}

বর্তমান স্টোরের সমস্ত প্রপার্টি মুছে ফেলতে, Properties.deleteAllProperties কল করুন:

service/propertyService.gs

GitHub-এ দেখুন

try {
  // Get user properties in the current script.
  const userProperties = PropertiesService.getUserProperties();
  // Delete all user properties in the current script.
  userProperties.deleteAllProperties();
} catch (err) {
  // TODO (developer) - Handle exception
  console.log("Failed with error %s", err.message);
}

স্ক্রিপ্ট প্রোপার্টিগুলো ম্যানুয়ালি পরিচালনা করুন

প্রজেক্ট সেটিংস পেজ থেকে ম্যানুয়ালি সর্বোচ্চ পঞ্চাশটি কাস্টম প্রপার্টি, কী-ভ্যালু পেয়ারে স্ট্রিং হিসেবে যোগ করুন। পঞ্চাশটির বেশি প্রপার্টি যোগ করতে, পূর্ববর্তী সেকশনের 'সেভ ডেটা' অংশে বর্ণিত পদ্ধতিগুলো ব্যবহার করে প্রোগ্রাম্যাটিকভাবে সেগুলো যোগ করুন। প্রজেক্ট সেটিংস পেজ থেকে স্ক্রিপ্ট প্রপার্টি সেট করার সময়, স্ক্রিপ্ট ভেরিয়েবল রেফারেন্স করবেন না।

স্ক্রিপ্ট বৈশিষ্ট্য যোগ করুন

1. আপনার গুগল অ্যাপস স্ক্রিপ্ট প্রজেক্টটি খুলুন।
2. বাম দিকে, প্রজেক্ট সেটিংস-এ ক্লিক করুন। .
3. প্রথম প্রপার্টিটি যোগ করতে, স্ক্রিপ্ট প্রপার্টিজ-এর অধীনে অ্যাড স্ক্রিপ্ট প্রপার্টি-তে ক্লিক করুন।
4. দ্বিতীয় এবং পরবর্তী প্রোপার্টিগুলো যোগ করতে, স্ক্রিপ্ট প্রোপার্টিজের অধীনে এডিট স্ক্রিপ্ট প্রোপার্টিজ > অ্যাড স্ক্রিপ্ট প্রোপার্টি-তে ক্লিক করুন।
5. প্রপার্টির জন্য, কী-এর নামটি লিখুন।
6. Value- এর জন্য, কী-টির মান লিখুন।
7. (ঐচ্ছিক) আরও প্রোপার্টি যোগ করতে, 'অ্যাড স্ক্রিপ্ট প্রোপার্টি'-তে ক্লিক করুন।
8. স্ক্রিপ্ট বৈশিষ্ট্য সংরক্ষণ করুন -এ ক্লিক করুন।

স্ক্রিপ্ট বৈশিষ্ট্য সম্পাদনা করুন

1. আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টটি খুলুন।
2. বাম দিকে, প্রজেক্ট সেটিংস-এ ক্লিক করুন। .
3. স্ক্রিপ্ট প্রোপার্টিজ- এর অধীনে, এডিট স্ক্রিপ্ট প্রোপার্টিজ-এ ক্লিক করুন।
4. আপনি যে প্রতিটি প্রপার্টি পরিবর্তন করতে চান, তার কী-নেম এবং কী-ভ্যালুতে পরিবর্তন আনুন।
5. স্ক্রিপ্ট বৈশিষ্ট্য সংরক্ষণ করুন -এ ক্লিক করুন।

স্ক্রিপ্ট প্রোপার্টিগুলো মুছে ফেলুন

1. আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টটি খুলুন।
2. বাম দিকে, প্রজেক্ট সেটিংস-এ ক্লিক করুন। .
3. স্ক্রিপ্ট প্রোপার্টিজ- এর অধীনে, এডিট স্ক্রিপ্ট প্রোপার্টিজ-এ ক্লিক করুন।
4. যে প্রপার্টিটি আপনি মুছতে চান, তার পাশে থাকা রিমুভ > ক্লিক করুন।
5. স্ক্রিপ্ট বৈশিষ্ট্য সংরক্ষণ করুন -এ ক্লিক করুন।