नाम वाली और सुरक्षित की गई रेंज

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

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

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

इसके अलावा, प्लेसहोल्डर NAMED_RANGE_ID और PROTECTED_RANGE_ID नाम वाली और सुरक्षित की गई रेंज के लिए आईडी दें. namedRangeId और protectedRangeId का इस्तेमाल संबंधित रेंज. आईडी को Sheets API के रिस्पॉन्स के तौर पर दिखाया जाता है अनुरोध है जो नाम वाली या सुरक्षित की गई रेंज बनाता है. आपको मौजूदा डोमेन आईडी का आईडी मिल सकता है रेंज spreadsheets.get तरीका, इसमें यह Spreadsheet जवाब का मुख्य हिस्सा.

नाम वाली या सुरक्षित की गई रेंज जोड़ें

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल, दो अनुरोध ऑब्जेक्ट को इस्तेमाल करने का तरीका बताता है. पहला, AddNamedRangeRequest A1:E3 रेंज को "Counts" नाम देने के लिए. दूसरा, AddProtectedRangeRequest का इस्तेमाल करें. इस लेवल की सुरक्षा अब भी रेंज में मौजूद सेल में बदलाव करने की अनुमति देता है, लेकिन इससे पहले एक चेतावनी दिखती है बदलाव कर रहे हैं.

इन अनुरोधों से AddNamedRangeResponse और एक AddProtectedRangeResponse, इसमें रेंज आईडी और प्रॉपर्टी शामिल हैं.

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

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

{
  "requests": [
    {
      "addNamedRange": {
        "namedRange": {
          "name": "Counts",
          "range": {
            "sheetId": SHEET_ID,
            "startRowIndex": 0,
            "endRowIndex": 3,
            "startColumnIndex": 0,
            "endColumnIndex": 5,
          },
        }
      }
    },
    {
      "addProtectedRange": {
        "protectedRange": {
          "range": {
            "sheetId": SHEET_ID,
            "startRowIndex": 3,
            "endRowIndex": 4,
            "startColumnIndex": 0,
            "endColumnIndex": 5,
          },
          "description": "Protecting total row",
          "warningOnly": true
        }
      }
    }
  ]
}

नाम वाली या सुरक्षित की गई रेंज मिटाएं

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल, दो अनुरोध ऑब्जेक्ट को इस्तेमाल करने का तरीका बताता है. पहला, DeleteNamedRangeRequest मौजूदा नाम वाली रेंज को मिटाने के लिए, NAMED_RANGE_ID पिछला एपीआई कॉल. दूसरा, DeleteProtectedRangeRequest PROTECTED_RANGE_ID का इस्तेमाल करके, किसी मौजूदा रेंज की सुरक्षा मिटाने के लिए .

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

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

{
  "requests": [
    {
      "deleteNamedRange": {
          "namedRangeId": "NAMED_RANGE_ID",
      }
    },
    {
      "deleteProtectedRange": {
        "protectedRangeId": PROTECTED_RANGE_ID,
      }
    }
  ]
}

नाम वाली या सुरक्षित की गई रेंज अपडेट करें

नीचे दिए गए spreadsheets.batchUpdate कोड सैंपल, दो अनुरोध ऑब्जेक्ट को इस्तेमाल करने का तरीका बताता है. पहला, UpdateNamedRangeRequest NAMED_RANGE_ID का इस्तेमाल करके, किसी मौजूदा नाम वाली रेंज के नाम को "InitialCounts" पर अपडेट करने के लिए . दूसरा, UpdateProtectedRangeRequest सुरक्षित की गई किसी मौजूदा रेंज को अपडेट करें, ताकि अब वह उसी नाम वाली रेंज को सुरक्षित रखे रेंज. कॉन्टेंट बनाने Editors तरीका सिर्फ़ सूची में शामिल उपयोगकर्ताओं को उन सेल में बदलाव करने की अनुमति देता है. यह अनुरोध, NAMED_RANGE_ID का इस्तेमाल करता है और पिछले एपीआई कॉल के PROTECTED_RANGE_ID.

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

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

{
  "requests": [
    {
      "updateNamedRange": {
        "namedRange": {
          "namedRangeId": NAMED_RANGE_ID,
          "name": "InitialCounts",
        },
        "fields": "name",
      }
    },
    {
      "updateProtectedRange": {
        "protectedRange": {
          "protectedRangeId": PROTECTED_RANGE_ID,
          "namedRangeId": NAMED_RANGE_ID,
          "warningOnly": false,
          "editors": {
            "users": [
              "charlie@example.com",
              "sasha@example.com"
            ]
          }
        },
        "fields": "namedRangeId,warningOnly,editors"
      }
    }
  ]
}