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

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

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

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

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

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल, एक ही फ़ाइल में 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 कोड सैंपल, एक ही फ़ाइल में 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 में पंक्ति या फिर पंक्ति में एक कॉलम सम्मिलित करने पर inheritFromBefore सही नहीं हो सकता कॉलम A.

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

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 कोड सैंपल, एक ही फ़ाइल में MoveDimensionRequest कॉलम A को कॉलम D की जगह पर ले जाने के लिए. दूसरे अनुरोध में पंक्तियां ट्रांसफ़र की जाती हैं 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
      }
    },
  ],
}