README

２つのアプリケーションクラス Insert と Readを持っています。日本の初学者が利用することを考えているためコメントや例外表記を日本語で記しています。学習用の教材として、スプレッドシートに近い感覚で利用できるよう作成したものであり、業務等で利用される場合は本家google\apiclientをお使いください。

Insert
Googleスプレッドシートへ「追記（append）」と「上書き（update）」を行う
ユーティリティクラス。値のネスト正規化も内包します。
【前提】
- 認証は SpreadSheetAuth が行い、Client を受け取ります
- .env（例：.env.local）に以下を定義

SHEET_ID="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

```
SHEET_NAME="シート1"
```
【想定する値の形】
- 2次元配列（複数行）
[[A1, B1, C1], [A2, B2, C2]]
- 1次元配列（1行のみ）
[A1, B1, C1] → 内部で [[A1, B1, C1]] に正規化
- 内部要素が配列の場合は改行結合 + JSON で安全に文字列化
【主なメソッド】
- insert($values, $range, $sheetName): 追記（append）
- update($values, $range, $sheetName): 上書き（update）
@package SpreadSheetWrapper\InterFace\GoogleSpreadSheet

/**

============================================================
Read
Googleスプレッドシートからデータを読み取るクラス。
【主な機能】
- 指定範囲を読み取り、列名(A,B,C,...)付きの連想配列として返す。
- .env から SHEET_ID / SHEET_NAME を自動読み込み。
【返り値形式】
[
["A" => 値1, "B" => 値2, "C" => 値3],
["A" => 値4, "B" => 値5, "C" => 値6],
...
]
【例】
$reader = new Read();
$rows = $reader->read("A1:C5");
============================================================ */

keisukesaichi / spread-sheet-wrapper

Maintainers

Details

README