डेटा से जुड़ी कार्रवाइयां

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

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

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

किसी रेंज पर डेटा की पुष्टि लागू करना

यहां दिया गया spreadsheets.batchUpdate कोड सैंपल दिखाता है कि SetDataValidationRequest का इस्तेमाल करके, डेटा की पुष्टि करने का नियम कैसे लागू किया जाता है. इस नियम के तहत, रेंज A1:D10 के हर सेल में "value > 5" लागू किया जाता है.

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

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

{
  "requests": [
    {
      "setDataValidation": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "rule": {
          "condition": {
            "type": "NUMBER_GREATER",
            "values": [
              {
                "userEnteredValue": "5"
              }
            ]
          },
          "inputMessage": "Value must be > 5",
          "strict": true
        }
      }
    }
  ]
}

सेल फ़ॉर्मैटिंग को कॉपी करके चिपकाना

The following spreadsheets.batchUpdate कोड सैंपल दिखाता है कि CopyPasteRequest का इस्तेमाल करके, सिर्फ़ रेंज A1:D10 में मौजूद फ़ॉर्मैटिंग को कॉपी करके, उसी शीट में मौजूद F1:I10 रेंज में कैसे चिपकाया जाता है. इस तरीके में, डेटा की पुष्टि को छोड़कर, फ़ॉर्मैटिंग चिपकाने के लिए, PasteType enum के साथ PASTE_FORMAT का इस्तेमाल किया जाता है. A1:D10 में मौजूद ओरिजनल वैल्यू में कोई बदलाव नहीं होता.

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

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

{
  "requests": [
    {
      "copyPaste": {
        "source": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "destination": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 5,
          "endColumnIndex": 9
        },
        "pasteType": "PASTE_FORMAT",
        "pasteOrientation": "NORMAL"
      }
    }
  ]
}

सेल को काटें और चिपकाएं

यहां दिया गया spreadsheets.batchUpdate कोड सैंपल दिखाता है कि CutPasteRequestका इस्तेमाल कैसे किया जाता है. इससे रेंज A1:D10 कट जाती है. साथ ही, उसी शीट में मौजूद F1:I10 रेंज में, इसकी वैल्यू, फ़ॉर्मूले, फ़ॉर्मैटिंग, और मर्ज की गई जानकारी को चिपकाने के लिए, PasteType enum के साथ PASTE_NORMAL का इस्तेमाल किया जाता है. सोर्स रेंज के सेल में मौजूद ओरिजनल कॉन्टेंट हटा दिया जाता है.

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

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

{
  "requests": [
    {
      "cutPaste": {
        "source": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "destination": {
          "sheetId": SHEET_ID,
          "rowIndex": 0,
          "columnIndex": 5
        },
        "pasteType": "PASTE_NORMAL"
      }
    }
  ]
}

किसी रेंज में फ़ॉर्मूला दोहराना

यहां दिया गया spreadsheets.batchUpdate कोड सैंपल दिखाता है कि RepeatCellRequest का इस्तेमाल करके, फ़ॉर्मूला =FLOOR(A1*PI()) को रेंज B1:D10 में कैसे कॉपी किया जाता है. रेंज में मौजूद हर पंक्ति और कॉलम के लिए, फ़ॉर्मूले की रेंज अपने-आप बढ़ जाती है. इसकी शुरुआत, सबसे ऊपर बाईं ओर मौजूद सेल से होती है. उदाहरण के लिए, सेल B1 में फ़ॉर्मूला =FLOOR(A1*PI()) है, जबकि सेल D6 में फ़ॉर्मूला =FLOOR(C6*PI()) है.

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

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

{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 1,
          "endColumnIndex": 4
        },
        "cell": {
          "userEnteredValue": {
              "formulaValue": "=FLOOR(A1*PI())"
          }
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

एक से ज़्यादा सॉर्टिंग स्पेसिफ़िकेशन के साथ किसी रेंज को सॉर्ट करना

spreadsheets.batchUpdate के लिए यहां दिया गया कोड सैंपल दिखाता है कि SortRangeRequest का इस्तेमाल करके, रेंज A1:D10 को कैसे सॉर्ट किया जाता है. इसे सबसे पहले, कॉलम B को बढ़ते क्रम में, फिर कॉलम C को घटते क्रम में, और आखिर में कॉलम D को घटते क्रम में सॉर्ट किया जाता है.

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

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

{
  "requests": [
    {
      "sortRange": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 4
        },
        "sortSpecs": [
          {
            "dimensionIndex": 1,
            "sortOrder": "ASCENDING"
          },
          {
            "dimensionIndex": 2,
            "sortOrder": "DESCENDING"
          },
          {
            "dimensionIndex": 3,
            "sortOrder": "DESCENDING"
          }
        ]
      }
    }
  ]
}