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

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

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

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

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

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल, एक ही फ़ाइल में SetDataValidationRequest डेटा की पुष्टि का नियम लागू करने के लिए, जहां "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
        }
      }
    }
  ]
}

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

नीचे दिए गए spreadsheets.batchUpdate सैंपल कोड में, यह बताया गया है कि CopyPasteRequest सिर्फ़ A1:D10 रेंज में फ़ॉर्मैटिंग को कॉपी करने और उसे F1:I10 रेंज में चिपकाने के लिए डालें. यह तरीका PasteType एनम 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 रेंज को काटता है और PasteType एनम इसमें PASTE_NORMAL की वैल्यू, फ़ॉर्मूले, फ़ॉर्मैटिंग, और मर्ज की गई सेल एक ही शीट में F1:I10 रेंज. मूल सोर्स रेंज की सेल का कॉन्टेंट यह है हटाया गया.

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

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 सीमा B1:D10 में =FLOOR(A1*PI()) फ़ॉर्मूला कॉपी करने के लिए. फ़ॉर्मूला की रेंज रेंज में हर पंक्ति और कॉलम के लिए अपने-आप बढ़ जाता है. इसकी शुरुआत ऊपर बायां सेल. उदाहरण के लिए, सेल 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"
          }
        ]
      }
    }
  ]
}