サンプル

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

多くの場合、API で特定のタスクを実行する方法は複数あります。タスクへのアプローチ方法を決定するときは、次の点に注意してください。

  • セル値を読み書きする必要がある場合は、spreadsheets コレクションよりも spreadsheets.values コレクションの方が適切です。単純な読み取り/書き込みオペレーションには、以前のインターフェースの方が使いやすくなっています。
  • 可能な限り、バッチメソッド(spreadsheet.batchUpdatespreadsheet.values.batchGetspreadsheet.values.batchUpdate)を使用して、複数のリクエストを 1 つのメソッド呼び出しにバンドルしてください。これらのバッチメソッドを使用すると、次の理由で効率が向上します。

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

レシピ

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

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

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