サンプル

このセクションでは、Google Sheets API に慣れるための Codelab を紹介します。また、目的の Google スプレッドシートのアクションを API リクエストに変換する方法を示す一連の「レシピ」サンプルも示します。

通常、API を使用して特定のタスクを実行する方法は複数あります。タスクのアプローチ方法を決定する際は、次の点に留意してください。

  • セル値を読み書きする必要がある場合は、spreadsheets コレクションよりも spreadsheets.values コレクションの使用をおすすめします。前者のインターフェースは、単純な読み取り/書き込みオペレーションに使いやすくなっています。

  • 可能な限り、バッチメソッド（spreadsheet.batchUpdate、spreadsheet.values.batchGet、spreadsheet.values.batchUpdate）を使用して、複数のリクエストを 1 つのメソッド呼び出しにバンドルしてください。これらのバッチ方式を使用すると、次の理由で効率が向上します。

    • クライアントの HTTP オーバーヘッドを削減します。
    • 実行するクエリの数を減らす。
    • ドキュメントの改訂版の数を減らす。
    • バッチ内のすべての変更のアトミック性を確保する。

レシピ

このセクションの例では、スプレッドシートでの一般的な操作を Sheets API v4 リクエストとして表現する方法を示しています。

これらの例では、言語に依存しない HTTP リクエストの形式で示しています。Google API クライアント ライブラリを使用して特定の言語で Sheets API リクエスト プロトコルを実装する方法については、セル値の読み取りと書き込みおよびスプレッドシートの更新のガイドをご覧ください。

このセクションのレシピは次のカテゴリに分類されます。