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

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

বৈশিষ্ট্য পরিষেবার জন্য দৈনিক কোটা এবং স্টোরেজ সীমা দেখতে, Google পরিষেবাগুলির জন্য কোটাগুলি দেখুন৷

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

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

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

ডেটা বিন্যাস

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

ডেটা সংরক্ষণ করা হচ্ছে

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

service/propertyService.gs
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
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(key) :

service/propertyService.gs
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
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
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(key) :

service/propertyService.gs
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
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. আপনার Apps স্ক্রিপ্ট প্রকল্প খুলুন.
  2. বাম দিকে, প্রকল্প সেটিংস ক্লিক করুন প্রকল্প সেটিংসের জন্য আইকন .
  3. প্রথম সম্পত্তি যোগ করতে, স্ক্রিপ্ট বৈশিষ্ট্যের অধীনে স্ক্রিপ্ট বৈশিষ্ট্য যোগ করুন ক্লিক করুন।
  4. দ্বিতীয় এবং পরবর্তী বৈশিষ্ট্য যোগ করতে, স্ক্রিপ্ট বৈশিষ্ট্যের অধীনে স্ক্রিপ্ট বৈশিষ্ট্য সম্পাদনা করুন > স্ক্রিপ্ট বৈশিষ্ট্য যোগ করুন ক্লিক করুন।
  5. সম্পত্তির জন্য, কী নাম লিখুন।
  6. মান- এর জন্য, কী-এর মান লিখুন।
  7. (ঐচ্ছিক) আরও বৈশিষ্ট্য যোগ করতে, স্ক্রিপ্ট বৈশিষ্ট্য যোগ করুন ক্লিক করুন।
  8. স্ক্রিপ্ট বৈশিষ্ট্য সংরক্ষণ করুন ক্লিক করুন.

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

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

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

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