पंक्ति और कॉलम की कार्रवाइयां

Google Sheets API की मदद से, शीट में लाइनें और कॉलम जोड़े, हटाए, और उनमें बदलाव किए जा सकते हैं. इस पेज पर दिए गए उदाहरणों से पता चलता है कि Sheets API की मदद से, लाइन और कॉलम से जुड़े कुछ सामान्य ऑपरेशन कैसे किए जा सकते हैं.

इन उदाहरणों को एचटीटीपी अनुरोधों के तौर पर दिखाया गया है, ताकि ये किसी भाषा पर आधारित न हों. Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके, अलग-अलग भाषाओं में बैच अपडेट लागू करने का तरीका जानने के लिए, स्प्रेडशीट अपडेट करना लेख पढ़ें.

इन उदाहरणों में, प्लेसहोल्डर SPREADSHEET_ID और SHEET_ID से पता चलता है कि आपको वे आईडी कहां देने हैं. स्प्रेडशीट के यूआरएल में, स्प्रेडशीट आईडी देखा जा सकता है. spreadsheets.get तरीके का इस्तेमाल करके, शीट आईडी पाया जा सकता है. रेंज को A1 नोटेशन का इस्तेमाल करके तय किया जाता है. उदाहरण के लिए, रेंज Sheet1!A1:D5 है.

कॉलम की चौड़ाई या लाइन की ऊंचाई में बदलाव करना

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल में, कॉलम A की चौड़ाई की प्रॉपर्टी को 160 पिक्सल पर अपडेट करने के लिए, UpdateDimensionPropertiesRequest का इस्तेमाल करने का तरीका बताया गया है. दूसरे अनुरोध में, पहली तीन लाइनों की ऊंचाई को 40 पिक्सल पर अपडेट किया गया है. dimension फ़ील्ड से यह तय होता है कि कार्रवाई, किसी शीट के कॉलम या लाइनों पर लागू होगी या नहीं.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "properties": {
          "pixelSize": 160
        },
        "fields": "pixelSize"
      }
    },
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "properties": {
          "pixelSize": 40
        },
        "fields": "pixelSize"
      }
    }
  ]
}

खाली पंक्तियां या कॉलम जोड़ना

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल में, पंक्तियों और कॉलम को जोड़ने के लिए AppendDimensionRequest का इस्तेमाल करने का तरीका बताया गया है. पहले अनुरोध में, किसी शीट के आखिर में तीन खाली लाइनें जोड़ी गई हैं. वहीं, दूसरे अनुरोध में एक खाली कॉलम जोड़ा गया है. dimension फ़ील्ड से यह तय होता है कि कार्रवाई, किसी शीट के कॉलम या लाइनों पर लागू होगी या नहीं.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "ROWS",
        "length": 3
      }
    },
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "COLUMNS",
        "length": 1
      }
    }
  ]
}

कॉलम का साइज़ अपने-आप बदलना

यहां दिए गए spreadsheets.batchUpdate कोड के उदाहरण में बताया गया है कि कॉलम A से C का साइज़ बदलने के लिए, AutoResizeDimensionsRequest का इस्तेमाल कैसे करें. कॉलम का साइज़, कॉलम के कॉन्टेंट के साइज़ के हिसाब से बदलता है. dimension फ़ील्ड से पता चलता है कि यह कार्रवाई, शीट के कॉलम पर लागू होती है.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

किसी लाइन का साइज़ अपने-आप बदलना

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल में, पहली तीन लाइनों की ऊंचाई को मिटाने के लिए AutoResizeDimensionsRequest का इस्तेमाल करने का तरीका बताया गया है. इसके बाद, हर लाइन में मौजूद सेल के कॉन्टेंट के आधार पर, लाइन की ऊंचाई डाइनैमिक रूप से बढ़ती है. dimension फ़ील्ड से पता चलता है कि यह कार्रवाई, शीट की लाइनों पर लागू होती है.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

पंक्तियां या कॉलम मिटाना

यहां दिए गए spreadsheets.batchUpdate कोड सैंपल में, किसी शीट की पहली तीन पंक्तियों को मिटाने के लिए DeleteDimensionRequest का इस्तेमाल करने का तरीका बताया गया है. दूसरे अनुरोध से, B:D कॉलम मिट जाते हैं. dimension फ़ील्ड से यह तय होता है कि कार्रवाई, किसी शीट के कॉलम या लाइनों पर लागू होगी या नहीं.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    },
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 1,
          "endIndex": 4
        }
      }
    },
  ],
}

खाली पंक्ति या कॉलम जोड़ना

यहां दिए गए spreadsheets.batchUpdate कोड के सैंपल में, InsertDimensionRequest का इस्तेमाल करने का तरीका बताया गया है. इसकी मदद से, किसी खास इंडेक्स पर कॉलम या लाइनें डाली जा सकती हैं. जैसे, किसी शीट में सबसे ऊपर खाली लाइनें जोड़ना. पहले अनुरोध में, कॉलम C में दो खाली कॉलम डाले जाते हैं. दूसरे अनुरोध में, पहली लाइन से शुरू होने वाली तीन खाली लाइनें जोड़ी जाती हैं.

dimension फ़ील्ड से यह तय होता है कि कार्रवाई, किसी शीट के कॉलम या लाइनों पर लागू होगी या नहीं.

अगर यह वैल्यू सही है, तो inheritFromBefore फ़ील्ड, Sheets API को यह निर्देश देता है कि नई पंक्तियों या कॉलम को पिछली पंक्ति या कॉलम की तरह ही प्रॉपर्टी दें. अगर यह वैल्यू गलत है, तो नई पंक्तियों या कॉलम के बाद के डाइमेंशन से इनहेरिट करें. अगर पहली पंक्ति में कोई पंक्ति या पहले कॉलम में कोई कॉलम डाला जा रहा है, तो inheritFromBefore को सही के तौर पर सेट नहीं किया जा सकता.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 2,
          "endIndex": 4
        },
        "inheritFromBefore": true
      }
    },
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "inheritFromBefore": false
      }
    },
  ],
}

किसी पंक्ति या कॉलम को एक जगह से दूसरी जगह ले जाना

यहां दिए गए spreadsheets.batchUpdate कोड के सैंपल में, कॉलम A को कॉलम D की जगह पर ले जाने के लिए MoveDimensionRequest का इस्तेमाल करने का तरीका दिखाया गया है. दूसरे अनुरोध से, पांचवीं से लेकर दसवीं लाइन तक की पंक्तियों को 20वीं लाइन पर ले जाया जाता है.

dimension फ़ील्ड से यह तय होता है कि कार्रवाई, किसी शीट के कॉलम या लाइनों पर लागू होगी या नहीं. destinationIndex फ़ील्ड से यह तय होता है कि सोर्स डेटा को कहां ले जाना है. इसके लिए, ज़ीरो से शुरू होने वाले इंडेक्स का इस्तेमाल किया जाता है.

अनुरोध का प्रोटोकॉल यहां दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "destinationIndex": 3
      }
    },
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 4,
          "endIndex": 10
        },
        "destinationIndex": 19
      }
    },
  ],
}