Google Sheets API の概要

Google Sheets API は、スプレッドシートのデータの読み取りと変更を可能にする RESTful インターフェースです。Sheets API を使用すると、次のことができます。

  • スプレッドシートを作成する
  • スプレッドシートのセル値の読み取りと書き込み
  • スプレッドシートの書式設定を更新する
  • コネクテッド シートを管理する

以下に、Sheets API で使用される一般的な用語を示します。

スプレッドシート

Google スプレッドシートの主要なオブジェクト。これには、それぞれ Cells に含まれる構造化された情報を持つ複数の Sheets を含めることができます。spreadsheets リソースは、スプレッドシートを表します。一意の spreadsheetId 値が含まれています。

スプレッドシート ID
スプレッドシートの一意の識別子。スプレッドシートを参照する文字、数字、一部の特殊文字を含む特定の文字列で、スプレッドシートの URL から取得できます。スプレッドシート ID は、スプレッドシートの名前が変更されても変わりません。
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
スプレッドシート

スプレッドシート内のページまたはタブ。Sheets リソースはシートを表します。SheetProperties オブジェクトの一部として、一意の数値 sheetId 値とシート title が含まれています。

シート ID
スプレッドシート内の特定のシートの一意の識別子。シートを参照する数値を含む特定の整数で、スプレッドシートの URL から取得できます。シート ID は、シート名が変更されても安定しています。例については、スプレッドシート ID をご覧ください。
Cell

シート内のテキストまたはデータの個々のフィールド。セルは行と列に配置され、セル範囲としてグループ化できます。Cells リソースは各セルを表しますが、一意の ID 値はありません。代わりに、行と列の座標でセルを識別します。

A1 表記
シート名と、列文字と行番号を使用した開始セルと終了セルの座標を含む文字列で、セルまたはセルの範囲を定義するために使用される構文。この方法は、セルの絶対範囲を参照する場合に最も一般的で便利です。
  • Sheet1!A1:B2 は、Sheet1 の最初の 2 行と 2 列のすべてのセルを指します。
  • Sheet1!A:A は、Sheet1 の 1 列目のすべてのセルを指します。
  • Sheet1!1:2 は、シート 1 の最初の 2 行のすべてのセルを指します。
  • Sheet1!A5:A は、シート 1 の最初の列の 5 行目以降のすべてのセルを指します。
  • A1:B2 は、最初の表示シートの最初の 2 行と列のすべてのセルを指します。
  • Sheet1 は、Sheet1 のすべてのセルを指します。
  • 'Jon's_Data'!A1:D5 は、「Jon's_Data」というシートの最初の 5 行と 4 列のすべてのセルを参照します。
  • 'My Custom Sheet'!A:A は、「My Custom Sheet」という名前のシートの最初の列のすべてのセルを指します。
  • 'My Custom Sheet' は、「My Custom Sheet」のすべてのセルを指します。

スペースまたは特殊文字を含むシート名には、単一引用符が必要です。

ヒント: 可能な場合は、スプレッドシート内のオブジェクトに異なる名前を使用してください。たとえば、A1（引用符なし）は、最初に表示されるシートのセル A1 を指します。'A1' は、A1 という名前のシートを参照します。同様に、Sheet1 は Sheet1 という名前のシートを参照します。ただし、「Sheet1」という名前の範囲がある場合、Sheet1 は名前付き範囲を参照し、'Sheet1' はシートを参照します。

R1C1 表記
シート名と、行番号と列番号を使用して開始セルと終了セルの座標を含む文字列で、セルまたはセルの範囲を定義するために使用される構文。この方法は A1 形式ほど一般的ではありませんが、特定のセルの位置を基準としてセルの範囲を参照する場合に便利です。
  • Sheet1!R1C1:R2C2 は、Sheet1 の最初の 2 行の最初の 2 つのセルを参照します。
  • R1C1:R2C2 は、最初に表示されるシートの上 2 行の最初の 2 つのセルを参照します。
  • Sheet1!R[3]C[1] は、現在のセルの 3 行下、1 列右のセルを指します。
名前付き範囲
アプリ全体で参照を簡素化するためにカスタム名が付けられた、定義済みのセルまたはセル範囲。FilterView リソースは、名前付き範囲を表します。
保護されている範囲
変更できない定義済みのセルまたはセル範囲。ProtectedRange リソースは、保護された範囲を表します。