> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CSV形式

> 一括作成用のCSVファイルの準備方法：必須ヘッダー、行、URLのルール、検証エラー。

一括作成では、シンプルなCSVファイルを読み込みます。1行目がヘッダー行で、その後にQRコードごとに名前と宛先URLを1行ずつ記載します。このページでは、アップロード時にGetQRがチェックするルールを説明します。

## サンプルファイル

```csv bulk-qr-template.csv theme={null}
name,url
Spring Menu,https://getqr.com/spring
Store #14,https://getqr.com/store-14
Table 7,example.com/menu?table=7
"Downtown, Main St",https://example.com/stores/downtown
```

このひな形はアプリからもダウンロードできます。**Add links** ステップで **Download CSV template** をクリックしてください。

## ルール

| 項目 | ルール |
| - | - |
| ファイル | `.csv` ファイルである必要があります。Excelやその他の形式は受け付けません。 |
| ヘッダー | 1行目は正確に `name,url` である必要があります（小文字、この順序、他の列なし）。 |
| 行 | 空でない行を最大100行。空の行は無視されます。 |
| `name` | 必須。QRコードの名前になります。最大40文字。それより長い名前は40文字に切り詰められます。 |
| `url` | 必須。`http://` または `https://` で始まるWebアドレス。 |

### URLのルール

* スキームを省略すると、GetQRが `https://` を追加します。`example.com/menu` は `https://example.com/menu` になります。
* アドレスには、`example.com` のようにドットを含む実在のドメインが必要です。
* スペース、タブ、改行は使用できません。
* Webリンクのみ使用できます。`mailto:`、`ftp://`、`javascript:`、単なるメールアドレスは拒否されます。

### 重複する名前

名前は一意である必要はありません。2つの行が同じ名前（大文字と小文字は区別しない）の場合、GetQRは重複に番号を付けます：`Menu`、`Menu 2`、`Menu 3`。

### カンマと引用符

名前にカンマが含まれる場合は、`"Downtown, Main St"` のようにダブルクォーテーションで囲みます。表計算アプリでCSVとして保存すると、自動的にこの処理が行われます。

## 表計算アプリでファイルを作成する

**1. 2つの列を用意する**

1行目のA列に `name`、B列に `url` と入力します。

**2. コードごとに1行追加する**

各行に名前とリンクを入力します（最大100行）。

**3. CSVとして保存する**

シートをCSVとして書き出すか保存します。Excelでは **CSV UTF-8** を選びます。Google スプレッドシートでは **File > Download > Comma-separated values** を選びます。

> [!TIP]
>
> UTF-8で保存すると、名前に含まれるアクセント付きの文字や日本語などの英語以外の文字がそのまま保たれます。

## 検証エラー

### ファイルのエラー

これらのエラーはファイル全体を停止させます。ファイルを修正して再度アップロードしてください。

| メッセージ | 対処法 |
| - | - |
| Choose a CSV file. Other file types are not supported. | ファイルを `.xlsx` や `.numbers` ではなく `.csv` で保存してください。 |
| The CSV header must be exactly name,url in that order. | 1行目を正確に `name,url` にしてください。大文字、余分な列、ヘッダーの欠落がないか確認してください。 |
| Add at least one non-empty data row to the CSV. | ファイルにヘッダーはありますが行がありません。名前とリンクを1つ以上追加してください。 |
| A CSV can contain at most 100 non-empty rows. | リストを100行以下のファイルに分割してください。 |
| This CSV is malformed and could not be read. | 表計算アプリからファイルを書き出し直してください。閉じられていない引用符がないか確認してください。 |

### 行のエラー

これらのエラーは個々の行に表示されます。修正して再アップロードするか、有効な行のみで続行できます。

| バッジまたはメッセージ | 原因 |
| - | - |
| **MISSING** / Name is required | `name` のセルが空です。 |
| **MISSING** / URL is required | `url` のセルが空です。 |
| **INVALID** / Enter a valid HTTP(S) URL | リンクが[URLのルール](#urlのルール)のいずれかに違反しています。 |

行番号はヘッダーを1行目として数えるため、最初のデータ行は2行目となり、表計算アプリでの行番号と一致します。

## よくある問題

> **ヘッダーは正しく見えるのに、ヘッダーのエラーが出る**
>
> ヘッダーは小文字で、2列のみである必要があります。`Name,URL` や `name,url,notes` はエラーになります。また、表計算アプリで `url` の右側に空の列がないかも確認してください。

> **ブラウザでは機能するリンクが INVALID と表示される**
>
> リンクにスペースが含まれているか、http または https 以外のスキームを使用している可能性があります。スペースは `%20` にエンコードするか削除し、完全なWebアドレスを使用してください。

> **一部の名前が短くなっている**
>
> 40文字を超える名前は40文字に切り詰められます。表現を自分で決めたい場合は、ファイル内で短くしてください。

## 次のステップ

> **[CSVからQRコードを作成する](/ja/bulk/create-from-csv)**
>
> ファイルをアップロードしてバッチを開始。

> **[一括作成の概要](/ja/bulk/overview)**
>
> 制限と一括作成の仕組み。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.