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
は Sheet1 の最初の列のすべてのセルを参照します。Sheet1!1:2
は Sheet1 の最初の 2 行のすべてのセルを参照します。Sheet1!A5:A
は、シート 1 の 5 行目以降のすべてのセルを参照します。A1:B2
は、最初に表示されるシートの上部 2 行にある最初の 2 つのセルを参照します。Sheet1
は Sheet1 のすべてのセルを参照します。'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 リソースは、保護されている範囲を表します。
次のステップ
認証や認可の処理など、Google Workspace API を使用した開発については、Google Workspace での開発をご覧ください。
シンプルな Sheets API アプリを構成して実行する方法については、クイックスタートの概要をご覧ください。