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
は、シート 1 の上 2 行にある最初の 2 つのセルを指します。Sheet1!A:A
は、シート 1 の最初の列にあるすべてのセルを参照します。Sheet1!1:2
は、シート 1 の最初の 2 行にあるすべてのセルを参照します。Sheet1!A5:A
は、シート 1 の 5 行目以降のすべてのセルを参照します。A1:B2
は、最初に表示されるシートの先頭 2 行にある最初の 2 つのセルを指します。Sheet1
はシート 1 内のすべてのセルを参照します。'My Custom Sheet'!A:A
は、「My Custom Sheet」という名前のシートの最初の列にあるすべてのセルを参照します。スペース、特殊文字、英数字の組み合わせを含むシート名には、一重引用符が必要です。'My Custom Sheet'
は「マイ カスタムシート」内のすべてのセルを指します。
ヒント: 可能な限り、スプレッドシート内のオブジェクトに個別の名前を使用してください。たとえば、A1 は最初に表示されるシートのセル A1 を参照し、「A1」は A1 という名前のシート内のすべてのセルを参照しています。同様に、「シート 1」は「シート 1」内のすべてのセルを参照します。ただし、「Sheet1」というタイトルの名前付き範囲がある場合、「Sheet1」は名前付き範囲を参照し、「Sheet1」はシートを参照しています。
- R1C1 表記
シート名、および行番号と列番号を使用して開始および終了のセル座標を含む文字列でセルまたはセル範囲を定義するために使用される構文。この方法は A1 表記ほど一般的ではありませんが、特定のセルの位置を基準としたセル範囲を参照する場合に便利です。
例を表示
Sheet1!R1C1:R2C2
は、シート 1 の上 2 行にある最初の 2 つのセルを指します。R1C1:R2C2
は、最初に表示されるシートの先頭 2 行にある最初の 2 つのセルを指します。Sheet1!R[3]C[1]
は、現在のセルの 3 行下 1 列にあるセルを指します。
- 名前付き範囲
アプリケーション全体で参照を簡素化するために、カスタム名を使用して定義されたセルまたはセル範囲。FilterView リソースは名前付き範囲を表します。
- 保護されている範囲
定義されたセルまたは変更できないセルの範囲。ProtectedRange リソースは保護された範囲を表します。
次のステップ
認証や認可の処理など、Google Workspace API を使用した開発については、Google Workspace での開発をご覧ください。
シンプルな Sheets API アプリを構成して実行する方法については、クイックスタートの概要をご覧ください。