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

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

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

इन उदाहरणों में, SPREADSHEET_ID और SHEET_ID प्लेसहोल्डर से पता चलता है कि आपको ऐसे आईडी कहां देने हैं. स्प्रेडशीट के यूआरएल में, स्प्रेडशीट आईडी देखा जा सकता है. spreadsheets.get तरीके का इस्तेमाल करके, शीट आईडी पाया जा सकता है. रेंज की जानकारी, A1 नोटेशन का इस्तेमाल करके दी जाती है. उदाहरण के लिए, Sheets1!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 को नए कॉलम या पंक्तियों को पिछली पंक्ति या कॉलम जैसी प्रॉपर्टी उपलब्ध कराने का निर्देश देता है. साथ ही, गलत होने पर, नए कॉलम या पंक्तियों के बाद वाले डाइमेंशन से इनहेरिट करने के लिए कहता है. पंक्ति 1 में पंक्ति या कॉलम A में कॉलम डालने पर, 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 का इस्तेमाल करने का तरीका बताया गया है. दूसरा अनुरोध करने पर, पंक्ति 5 से 10 तक की पंक्ति 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
      }
    },
  ],
}