サンプル

このセクションでは、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 リクエスト プロトコルを実装する方法については、セル値の読み取りと書き込みとスプレッドシートの更新のガイドをご覧ください。

このセクションのレシピは、次のカテゴリに分かれています。