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 行と列のすべてのセルを指します。
  • Sheet1!A:A は Sheet1 の 1 列目のすべてのセルを指します。
  • Sheet1!1:2 は Sheet1 の最初の 2 行にあるすべてのセルを指します。
  • Sheet1!A5:A は、Sheet1 の先頭列にある 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' は「マイ カスタムシート」のすべてのセルを指します。

スペース、特殊文字、英数字の組み合わせを含むシート名には、単一引用符が必要です。

ヒント: 可能であれば、スプレッドシート内のオブジェクトに異なる名前を付けます。たとえば、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 リソースは、保護された範囲を表します。