रेंज की वैल्यू प्राप्त करना

इस लेख में स्प्रेडशीट से किसी खास रेंज की वैल्यू प्राप्त करने का तरीका समझाया गया है।

इस्तेमाल होने वाला मेथड

Sheet.getSheetValues([शुरुआती पंक्ति], [शुरुआती कॉलम], [पंक्तियों की संख्या], [कॉलम की संख्या]);

इसके लिए Sheet क्लास में उपलब्ध getSheetValues() का इस्तेमाल किया जाता है।

Spreadsheet क्लास में भी इसी नाम का मेथड मौजूद है, लेकिन यहाँ हम Sheet क्लास का मेथड इस्तेमाल करेंगे, क्योंकि इसमें लक्षित शीट को साफ़ तौर पर बताया जा सकता है।

इसमें 4 आर्ग्युमेंट देने होते हैं: शुरुआती पंक्ति, शुरुआती कॉलम, पंक्तियों की संख्या और कॉलम की संख्या।

उदाहरण के लिए, अगर लक्षित शीट में सेल C2 से शुरू होकर 4 पंक्तियों × 5 कॉलम की रेंज (C2:G5) प्राप्त करनी है, तो getSheetValues(2, 3, 4, 5) लिखें।

रिटर्न वैल्यू, वैल्यू के 2-डायमेंशनल ऐरे (Object[][]) के रूप में मिलती है। सेल की सामग्री के अनुसार, हर एलिमेंट संख्या, बूलियन, तारीख (Date) या स्ट्रिंग में से कोई एक होता है।

इसका परिणाम sheet.getRange(2, 3, 4, 5).getValues() जैसा ही होता है।

चलाते समय स्प्रेडशीट को ऐक्सेस किया जाता है, इसलिए पहली बार चलाने पर ऑथराइज़ेशन की ज़रूरत पड़ सकती है।

सैंपल कोड

/**
 * लक्षित स्प्रेडशीट की ID
 * https://docs.google.com/spreadsheets/d/xxx/edit में xxx वाला हिस्सा
 */
const SPREAD_SHEET_ID = '_______________';

/**
 * चुनी गई रेंज की वैल्यू प्राप्त करता है
 */
const getSheetValues = () => {
  /** लक्षित स्प्रेडशीट */
  const ss = SpreadsheetApp.openById(SPREAD_SHEET_ID);

  /** लक्षित शीट */
  const sheet = ss.getSheetByName('Sheet1');

  if (!sheet) {
    console.log('शीट नहीं मिली');
    return null;
  }

  /** प्राप्त किया गया डेटा */
  const arrays = sheet.getSheetValues(2, 3, 4, 5);

  console.log(arrays);
  return arrays;
};

इसे चलाने पर, चुनी गई स्प्रेडशीट की “Sheet1” शीट से, C2 से शुरू होने वाली 4 पंक्तियों × 5 कॉलम की रेंज (C2:G5) की वैल्यू लौटाई जाती हैं।