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

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

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

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

शीट जोड़ें

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल, एक ही फ़ाइल में AddSheetRequest स्प्रेडशीट में शीट जोड़ने के लिए, शीर्षक, ग्रिड का साइज़, और टैब का रंग.

इसके जवाब में AddSheetResponse इसमें ऐसा ऑब्जेक्ट होता है जिसमें बनाई गई शीट की प्रॉपर्टी होती हैं (जैसे कि SHEET_ID).

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

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

{
  "requests": [
    {
      "addSheet": {
        "properties": {
          "title": "Deposits",
          "gridProperties": {
            "rowCount": 20,
            "columnCount": 12
          },
          "tabColor": {
            "red": 1.0,
            "green": 0.3,
            "blue": 0.4
          }
        }
      }
    }
  ]
}

फ़ॉर्मैट को सुरक्षित रखते हुए, सभी वैल्यू वाली शीट को मिटाएं

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल, एक ही फ़ाइल में UpdateCellsRequest का इस्तेमाल करें.

userEnteredValue फ़ील्ड उससे जुड़े मान के बिना, वैल्यू को साफ़ करने के निर्देश के तौर पर समझा जाता है सीमा में रखें. इस सेटिंग का इस्तेमाल अन्य फ़ील्ड के साथ भी किया जा सकता है. उदाहरण के लिए, fields वैल्यू को बदलकर यह किया जा रहा है: userEnteredFormat हटाता है Sheets API में सभी फ़ॉर्मैट काम करते हैं लेकिन सेल की वैल्यू में कोई बदलाव नहीं किया जाता.

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

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

{
  "requests": [
    {
      "updateCells": {
        "range": {
          "sheetId": SHEET_ID
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

शीट को एक स्प्रेडशीट से दूसरी स्प्रेडशीट में कॉपी करना

नीचे दिए गए spreadsheet.sheets.copyTo कोड सैंपल, SHEET_ID की ओर से तय की गई एक शीट को कॉपी करने का तरीका बताता है स्प्रेडशीट से डेटा एक्सपोर्ट कर सकते हैं.

अनुरोध के मुख्य हिस्से में TARGET_SPREADSHEET_ID वैरिएबल से यह पता चलता है गंतव्य स्प्रेडशीट. कॉपी में सभी वैल्यू, फ़ॉर्मैटिंग, फ़ॉर्मूला, और प्रॉपर्टी से मिलती-जुलती अन्य प्रॉपर्टी शामिल करें. कॉपी की गई शीट का टाइटल "कॉपी करें" पर सेट है [ओरिजनल शीट का टाइटल]" का इस्तेमाल करें.

इसके जवाब में SheetProperties ऑब्जेक्ट है, जो बनाई गई शीट की प्रॉपर्टी के बारे में बताता है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/sheets/SHEET_ID:copyTo

{
  "destinationSpreadsheetId": "TARGET_SPREADSHEET_ID"
}

शीट को मिटाना

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल, एक ही फ़ाइल में DeleteSheetRequest SHEET_ID के ज़रिए तय की गई शीट को मिटाने के लिए.

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

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

{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": SHEET_ID
      }
    }
  ]
}

शीट का डेटा देखें

नीचे दिए गए spreadsheets.get कोड सैंपल शीट प्रॉपर्टी की जानकारी पाने का तरीका दिखाता है SHEET_ID में बताई गई स्प्रेडशीट से ली गई है और SPREADSHEET_ID. इस तरीके का इस्तेमाल अक्सर यह तय करने के लिए किया जाता है कि किसी स्प्रेडशीट में शीट का मेटाडेटा होता है, ताकि दूसरी कार्रवाइयों के ज़रिए टारगेट करने के लिए. fields क्वेरी पैरामीटर से सिर्फ़ शीट प्रॉपर्टी के बारे में पता चलता है दिया जाना चाहिए (सेल वैल्यू के डेटा या स्प्रेडशीट).

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?&fields=sheets.properties

इसके जवाब में Spreadsheet संसाधन होता है, जिसमें Sheet ऑब्जेक्ट, SheetProperties एलिमेंट. अगर दिया गया जवाब फ़ील्ड डिफ़ॉल्ट मान पर सेट है, तो उसे छोड़ दिया जाता है पहले से चुना हुआ है.

{
  "sheets": [
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "Sheet1",
        "index": 0,
        "sheetType": "GRID",
        "gridProperties": {
          "rowCount": 100,
          "columnCount": 20,
          "frozenRowCount": 1
        }
        "tabColor": {
          "blue": 1.0
        }
      },
      ...
  ],
}