Google Sheets API の概要

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

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

Sheets API で使用される一般的な用語は次のとおりです。

スプレッドシート

複数のシート(それぞれがセル内に構造化された情報を含む)を格納できる Google スプレッドシートのプライマリ オブジェクト。スプレッドシート リソースは、すべてのスプレッドシートを表し、文字、数字、ハイフン、アンダースコアを含む一意の spreadsheetId 値を持ちます。スプレッドシート ID は Google スプレッドシートの URL で確認できます。

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

スプレッドシート

スプレッドシート内のページまたはタブ。シート リソースは各シートを表し、一意のタイトルと数値 sheetId 値を持ちます。シート ID は Google スプレッドシートの URL で確認できます。

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

セル

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

A1 表記

シート名、列の文字と行番号を使用した開始および終了のセル座標を含む文字列で、セルまたはセル範囲を定義するために使用される構文。この方法は、セルの絶対範囲を参照する場合に最も一般的で便利です。

例を表示

  • Sheet1!A1:B2 は、Sheet1 の一番上 2 行にある最初の 2 つのセルを参照します。
  • Sheet1!A:A は、シート 1 の最初の列にあるすべてのセルを参照します。
  • Sheet1!1:2 は、Sheet1 の最初の 2 行にあるすべてのセルを参照します。
  • Sheet1!A5:A は、シート 1 の 5 行目以降のすべてのセルを参照します。
  • A1:B2 は、最初に表示されるシートの最初の 2 行にある最初の 2 つのセルを参照します。
  • Sheet1 はシート 1 内のすべてのセルを参照します。
  • 'My Custom Sheet'!A:A は、「マイカスタム シート」という名前のシートの最初の列にあるすべてのセルを参照します。スペース、特殊文字、英数字の組み合わせを含むシート名には単一引用符が必要です。
  • 'My Custom Sheet' は「マイカスタム シート」内のすべてのセルを参照します。

ヒント: できるだけスプレッドシート内のオブジェクトに個別の名前を使用してください。たとえば、A1 は最初に表示されるシートのセル A1 を参照し、「A1」は A1 という名前のシート内のすべてのセルを参照します。同様に、「シート 1」は「シート 1」内のすべてのセルを参照します。ただし、「シート 1」というタイトルの名前付き範囲がある場合は、「シート 1」は名前付き範囲を参照し、「シート 1」はシートを参照します。

R1C1 表記

シート名、行番号と列番号を使用した開始および終了のセル座標を含む文字列で、セルまたはセル範囲を定義するために使用される構文。この方法は A1 表記ほど一般的ではありませんが、特定のセルの位置を基準としてセル範囲を参照する場合に便利です。

例を表示

  • Sheet1!R1C1:R2C2 は、Sheet1 の一番上 2 行にある最初の 2 つのセルを参照します。
  • R1C1:R2C2 は、最初に表示されるシートの最初の 2 行にある最初の 2 つのセルを参照します。
  • Sheet1!R[3]C[1] とは、現在のセルより下 3 行、右 1 列にあるセルを指します。
名前付き範囲

アプリケーション全体で参照を簡素化するために、カスタム名を持つ定義済みのセルまたはセル範囲。FilterView リソースは名前付き範囲を表します。

保護されている範囲

定義済みで、変更できないセルまたはセル範囲。ProtectedRange リソースは保護された範囲を表します。

次のステップ