इस गाइड में, Google Sheets API का इस्तेमाल करके अपनी स्प्रेडशीट में टेबल बनाने का तरीका बताया गया है. साथ ही, यह भी बताया गया है कि इसका इस्तेमाल क्यों करना चाहिए.
टेबल क्या होती है?
टेबल की मदद से डेटा को आसानी से मैनेज किया जा सकता है. साथ ही, डेटा रेंज में फ़ॉर्मैट और स्ट्रक्चर को अपने-आप लागू करने की सुविधा से बार-बार फ़ॉर्मैट, इनपुट, और अपडेट करने की ज़रूरत कम हो जाती है.
टेबल में कई सुविधाएं होती हैं. जैसे, हेडर, फ़ुटर, कॉलम के टाइप, फ़िल्टर, व्यू, टेबल के रेफ़रंस, और टेबल के नाम. ज़्यादा जानकारी के लिए, सुविधा से जुड़ी सूचना देखें. साथ ही, Sheets में टेबल इस्तेमाल करने के बारे में जानें.
टेबल का इस्तेमाल, प्रोजेक्ट ट्रैकिंग, इवेंट प्लानिंग, और इन्वेंट्री मैनेजमेंट जैसे कामों के लिए किया जा सकता है.
टेबल जोड़ें
टेबल जोड़ने के लिए, batchUpdate तरीके का इस्तेमाल करें. इसके लिए, addTable अनुरोध सबमिट करें. इस अनुरोध का इस्तेमाल, स्प्रेडशीट में टेबल जोड़ने के लिए किया जाता है.
यहां दिए गए उदाहरण में, range पर "प्रोजेक्ट ट्रैकर" नाम की टेबल बनाई गई है. इसमें दो कॉलम सेट किए गए हैं. पहले कॉलम में प्रतिशत कॉलम और दूसरे कॉलम में ड्रॉपडाउन कॉलम टाइप.
{
"addTable": {
"table": {
"name": "Project Tracker",
"tableId": "123",
"range": {
"sheetId": 0,
"startColumnIndex": 0,
"endColumnIndex": 5,
"startRowIndex": 0,
"endRowIndex": 5,
},
"columnProperties": [
{
"columnIndex": 0,
"columnName": "Column 1",
"columnType": "PERCENT"
},
{
"columnIndex": 1,
"columnName": "Column 2",
"columnType": "DROPDOWN",
"dataValidationRule": {
"condition": {
"type": "ONE_OF_LIST",
"values": [
{
"userEnteredValue": "Not Started"
},
{
"userEnteredValue": "In Progress"
},
{
"userEnteredValue": "Complete"
}
]
}
}
}
],
}
}
}
कॉलम के टाइप
टेबल में कॉलम टाइप होते हैं. जैसे, संख्या, तारीख, ड्रॉपडाउन, स्मार्ट चिप, चेकबॉक्स. रेटिंग और चेकबॉक्स कॉलम टाइप में, डिफ़ॉल्ट वैल्यू के तौर पर 0 और FALSE अपने-आप भर जाते हैं.
ड्रॉपडाउन कॉलम टाइप
ड्रॉपडाउन कॉलम टाइप से, चिप वाला ड्रॉपडाउन बनता है. अगर कॉलम का टाइप ड्रॉपडाउन के तौर पर सेट किया गया है, तो कॉलम के लिए dataValidationRule को ONE_OF_LIST शर्त के साथ सेट किया जाना चाहिए. अन्य कॉलम टाइप के लिए, `dataValidationRule
field सेट नहीं किया जाना चाहिए.
किसी टेबल को अपडेट करना
spreadsheets.batchUpdate
तरीके का इस्तेमाल करें और UpdateTableRequest उपलब्ध कराएं.
टेबल के साइज़ में बदलाव करना
टेबल में नई पंक्तियां/कॉलम जोड़ने के लिए, range में बदलाव करने के लिए UpdateTableRequest
तरीके का इस्तेमाल करें.
अगर आपको टेबल में कोई नई लाइन या कॉलम जोड़ना है, तो InsertRangeRequest या InsertDimensionRequest का इस्तेमाल करें
अगर आपको टेबल की कोई लाइन मिटानी है, तो DeleteRangeRequest का इस्तेमाल करें. इसके अलावा, अगर आपको स्प्रेडशीट की पूरी लाइन मिटानी है, तो DeleteDimensionRequest का इस्तेमाल करें.
टेबल के फ़ुटर को टॉगल करें
अगर आपको फ़ुटर जोड़ने के लिए, फ़ुटर के बिना किसी मौजूदा टेबल को अपडेट करना है, तो range एक लाइन बढ़ जाता है. अगर आपको फ़ुटर वाली किसी मौजूदा टेबल को अपडेट करना है और फ़ुटर हटाना है, तो range एक लाइन कम हो जाता है.
किसी टेबल में वैल्यू जोड़ना
टेबल के आखिर में लाइनें जोड़ने के लिए, AppendCellsRequest
के साथ tableId का इस्तेमाल करें. यह फ़ंक्शन, वैल्यू को पहली खाली लाइन में जोड़ता है. साथ ही, इसे पूरी लाइनों और फ़ुटर के बारे में पता होता है. अगर कोई खाली लाइन नहीं है, तो यह टेबल के आखिर में और फ़ुटर से पहले लाइनें जोड़ता है. हालांकि, ऐसा तब होता है, जब फ़ुटर मौजूद हो.
किसी टेबल को मिटाना
spreadsheets.batchUpdate तरीके का इस्तेमाल करें और DeleteTableRequest उपलब्ध कराएं.
पूरी टेबल और उसके कॉन्टेंट को मिटाने के लिए, DeleteTableRequest का इस्तेमाल करें.
टेबल की फ़ॉर्मैटिंग हटाने के लिए, DeleteBandingRequest का इस्तेमाल करें. हालांकि, इससे डेटा नहीं मिटेगा.
टेबल का इस्तेमाल, Sheets की अन्य सुविधाओं के साथ करना
टेबल में मौजूद डेटा के साथ काम करने वाली अन्य API सुविधाओं में ये शामिल हैं: फ़िल्टर, फ़िल्टर व्यू, और सुरक्षित रेंज.