名前付き範囲と保護されている範囲

Google Sheets API では、名前付きまたは保護されたデータを作成、変更、削除できる あります。このページの例では、一般的な Sheets API によるスプレッドシート オペレーション。

これらの例は、HTTP リクエストという形式で示されています。これは、 ニュートラルです。異なる言語のバッチ アップデートを実装する方法については、 Google API クライアント ライブラリについては、 スプレッドシート

これらの例では、プレースホルダ SPREADSHEET_IDSHEET_ID は、 は、これらの ID を指定する場所を示しています。そのスプレッドシートの ID を入力します。取得できるもの: シート ID spreadsheets.get メソッドを使用します。「 範囲は A1 表記で指定します。「 Sheet1!A1:D5 です。

また、プレースホルダ NAMED_RANGE_IDPROTECTED_RANGE_ID も、 名前付き範囲と保護されている範囲の ID を指定します。namedRangeIdprotectedRangeId は、ファイルの更新や削除をリクエストするときに使用されます。 関連付けられますSheets API へのレスポンスで ID が返されます。 名前付き範囲または保護されている範囲を作成するリクエストです。既存の VM の ID を 範囲を spreadsheets.get メソッド( Spreadsheet レスポンスの本文です

名前付き範囲または保護されている範囲を追加

次の spreadsheets.batchUpdate コードサンプルは、2 つのリクエスト オブジェクトの使用方法を示しています。1 つ目は、 AddNamedRangeRequest 範囲 A1:E3 に「Counts」という名前を割り当てます。2 つ目は、 AddProtectedRangeRequest 範囲 A4:E4 に警告レベルの保護を適用します。このレベルの保護 範囲内のセルの編集は引き続き許可されますが、編集前に警告メッセージが表示されます。 変更を行います。

これらのリクエストでは、 AddNamedRangeResponse および AddProtectedRangeResponse、 範囲 ID とプロパティが含まれます。

リクエスト プロトコルを以下に示します。

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 コードサンプルは、2 つのリクエスト オブジェクトの使用方法を示しています。1 つ目は、 DeleteNamedRangeRequest 既存の名前付き範囲を削除するには、NAMED_RANGE_ID 確認できます。2 つ目は、 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 コードサンプルは、2 つのリクエスト オブジェクトの使用方法を示しています。1 つ目は、 UpdateNamedRangeRequest NAMED_RANGE_ID を使用して、既存の名前付き範囲の名前を「InitialCounts」に更新します。 データを取得できます。2 つ目は、 UpdateProtectedRangeRequest 既存の保護されている範囲を更新して、同じ名前付き範囲を あります。「 Editors メソッド リストされたユーザーのみがこれらのセルを編集できます。このリクエストでは NAMED_RANGE_ID を使用します。 以前の API 呼び出しの 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"
      }
    }
  ]
}