フィールドデータ型
すべてのフィールドには型があります — 検証・入力・表示の仕方を決めます。金額には通貨ピッカー、日付にはカレンダー、SSN はマスク、ドロップダウンはリストから選びます。
型を手で設定することはめったにありません — SheetApps がフィールド名とサンプルデータから読み取ります。明示するには、Rules シートの Data type 列に書きます(多くの分かりやすい表記が使えます)。以下が全カタログです:
| 型 | 検証内容 |
|---|---|
| text / textarea | 自由テキスト。text(20) で任意の長さ制限を設定できます — 最大 20 文字(textarea にも適用)。 |
| integer | 整数のみ(小数なし)。分割できない品目の個数・数量などに使用します。 |
| number / decimal | 小数を含む数値(別名:numeric、decimal、float)。既定で小数 2 桁。decimal(4) で上書きできます。 |
| quantity | 単位付きの小数量 — 例:「12.50 kg」。単位ピッカーが付き、レコードごとに単位を選べます。単位がどう検出・共有されるかは通貨と単位を参照してください。 |
| currency / amount | 金額(別名:amount、money)。通貨ピッカーが付き、レコードごとに通貨を選べます。空欄のときはアプリの既定通貨を使います。ピッカーがどう検出・共有・配置されるかは通貨と単位を参照してください。 |
| percent | % 記号付きのパーセント値(15 →「15%」)。 |
| date | カレンダー日付(YYYY-MM-DD)。日付選択を表示します。 |
| year | 4桁の暦年(例: 2026)。年のドロップダウンで表示され、「年 / 会計年度 / FY」という名前の整数列から自動検出されます。 |
| month | 年を含む暦月 — YYYY-MM 形式で保存(例: 2026-07)。月ピッカーで表示され、「月」という名前の日付列から自動検出されます。 |
| datetime | 日付と時刻の組み合わせ(例: 2026-07-13 14:30)。日時ピッカーで表示され、実際の時刻成分を持つセルから自動検出されます。 |
| time | 時刻 — HH:MM(例: 09:30)。時刻ピッカーで表示され、時刻のセルから自動検出されます。 |
| メールアドレス。 | |
| boolean | 真/偽(チェックボックス)。 |
| dropdown | ルックアップリスト(List_ シートまたは標準リスト)から選択した値。 |
| ssn | 米国 SSN(マスク)。 |
| zip | 5 桁の ZIP または ZIP+4。 |
| phone | 国番号のドロップダウン付き電話(既定 +1)。 |
| credit_card | 13〜19 桁 + Luhn チェック(マスク)。保存されるのは末尾 4 桁のみ — 完全な番号は保存時に一度だけ検証され、決して永続化されません。 |
| upc / routing_number | UPC-A チェックディジット/9 桁の ABA ルーティングチェックサム。 |
| url | Web/URL リンク。 |
| file | 汎用ファイル添付(サイズ制限はフィールドの下に表示)。画像・PDF・テキストはブラウザー内でプレビューされます。スクリプトは拒否されます。特定のメディアには下記の image / video / audio / doc 型を使用してください。 |
| image | 画像アップロード(jpg, png, webp, gif, bmp — SVG 不可)。サムネイルを表示。クリックで原寸表示、ダウンロード可。 |
| video | 動画アップロード(mp4, mov, webm)。サムネイルを表示。クリックでその場で再生、ダウンロード可。 |
| audio | 音声アップロード(mp3, wav, ogg, m4a)。インラインで再生、ダウンロードボタン付き。 |
| doc | ドキュメントのアップロード — 読み取り専用。PDF・テキスト・CSV はブラウザーでプレビュー。Word・Excel・PowerPoint はダウンロード。安全なドキュメント形式のみ受け付けます。 |
| relation | フォーム間ルックアップ:同じアプリ内の別フォームのレコードを、そのフォームのビジネスキーで参照します。検索可能なレコード選択として表示され、選んだレコードのキーを保存します。 |
| ulid / nanoid | レコード作成時にアプリが自動入力する、読み取り専用の識別子。ulid — 26 文字でソート可能な ID。nanoid — コンパクトなランダム ID(長さの既定値は 21、nanoid(10) で長さ 10)。どちらも Crockford base32(大文字、紛らわしい I L O U を除く)を使用します。 |
型の決まり方(上位が優先):(1) ルールシートでの明示的な データ型;(2) フィールド名 —
date を含む名前 → 日付、price/amount/total/cost/fee → 通貨、quantity/qty → 数量、count/units → 整数、さらに ssn、zip、phone、email、image/photo → 画像、video → 動画、audio/sound → 音声、document/pdf → ドキュメント、file;(3) サンプルデータの値とセルの書式 — 整数 → 整数、小数を含む数値 → 数値、通貨として書式設定されたセル($ € £ など)→ 通貨;(4) それ以外は text。ここまでがフィールド型です。組み込みの標準リスト(国・通貨・単位…)、地域対応の書式、リレーションの完全な文法は、データ型リファレンスを参照してください。