इस गाइड में बताया गया है कि अपनी स्प्रेडशीट में टेबल बनाने के लिए, 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 के तरीके का इस्तेमाल करें. टेबल में नई लाइनें/कॉलम जोड़ने के लिए, range में बदलाव करना ज़रूरी है.
अगर आपको टेबल में कोई नई पंक्ति या कॉलम जोड़ना है, तो InsertRangeRequest या InsertDimensionRequest का इस्तेमाल करें
अगर आपको टेबल की कोई लाइन मिटानी है, तो DeleteRangeRequest का इस्तेमाल करें. इसके अलावा, स्प्रेडशीट से पूरी लाइन मिटाने के लिए, DeleteDimensionRequest का इस्तेमाल करें.
टेबल फ़ुटर को टॉगल करना
अगर फ़ुटर जोड़ने के लिए, फ़ुटर के बिना किसी मौजूदा टेबल को अपडेट किया जा रहा है, तो range एक पंक्ति तक बड़ा हो जाता है. अगर फ़ुटर वाली किसी मौजूदा टेबल को अपडेट किया जा रहा है और फ़ुटर को हटाया जा रहा है, तो range एक पंक्ति छोटा हो जाता है.
टेबल में वैल्यू जोड़ना
टेबल के आखिर में लाइनें जोड़ने के लिए, tableId के साथ AppendCellsRequest का इस्तेमाल करें. यह वैल्यू को पहली खाली पंक्ति में जोड़ता है. साथ ही, यह पूरी पंक्तियों और फ़ुटर के बारे में भी जानता है. अगर कोई खाली पंक्ति नहीं है, तो यह टेबल के आखिर में और किसी फ़ुटर से पहले पंक्तियां डालता है. हालांकि, ऐसा तब ही होता है, जब फ़ुटर मौजूद हो.
टेबल मिटाना
spreadsheets.batchUpdate वाला तरीका इस्तेमाल करें और DeleteTableRequest सबमिट करें.
पूरी टेबल और टेबल का कॉन्टेंट मिटाने के लिए, DeleteTableRequest का इस्तेमाल करें.
टेबल की फ़ॉर्मैटिंग हटाने के लिए, DeleteBandingRequest का इस्तेमाल करें. हालांकि, डेटा को सेव रखें.
Sheets की अन्य सुविधाओं के साथ टेबल का इस्तेमाल करना
टेबल को बैकिंग डेटा के तौर पर इस्तेमाल करने की सुविधा देने वाली अन्य एपीआई सुविधाओं में, फ़िल्टर, फ़िल्टर व्यू, और सुरक्षित की गई रेंज शामिल हैं.