やること
- 必須の
destination列と任意のslug、title、tags列を含むCSVを用意します。 - 何かが書き込まれる前にエラーをアップロードしてプレビュー — 無効な行はハイライト表示され、スキップできます。
- 1回のインポートで最大50,000件のリンクを実行。スラッグが空白の行ではインポーターがべき等のため、同じファイルを安全に再実行できます。
一度にすべての宛先URLを短縮したいスプレッドシートがある場合 — 別のツールから移行する、キャンペーンを開始する、または新しいワークスペースにデータを入れる — 一括インポーターが正しい方法です。確定前にミスをプレビューするため、部分的なインポートなしに問題を修正できます。
CSVフォーマット#
インポーターはヘッダー行付きのカンマ区切りファイルを想定しています。唯一の必須列は destination です。それ以外はすべてオプションです。
destination,slug,title,tags
https://acme.com/spring-sale,spring-2026,Spring Sale 2026,campaign:spring
https://acme.com/about,,About Us,
https://acme.com/contact,contact-us,,support:contact
列のルール：
- destination（必須）—
https://を含む完全なURL。スキームのないURLは拒否されます。 - slug（オプション）— カスタムの短いスラッグ。文字、数字、ハイフンのみ。空白の場合、6文字のランダムなコードを生成します。
- title（オプション）— リンクリストに表示される読みやすいラベル。
- tags（オプション）— コロンまたはセミコロンで区切られた1つ以上のタグ。タグが存在しない場合は自動的に作成されます。
ヘッダー名が一致している限り、列の順序は関係ありません。余分な列は無視されます。
インポートの開始#
- Tools → Bulk import に移動します（または Links からインポートボタンをクリックします）。
- CSVファイルをアップロードします。インポーターがそれを解析してプレビューテーブルを表示します。
- プレビューを確認します。エラーがある行は強調表示されます — エラーアイコンにカーソルを合わせて何が問題かを確認します。
- Import をクリックして有効な行を書き込みます。エラーのある行はスキップされます。
インポートはバックグラウンドで実行されます。大きなファイルの場合、進行状況インジケーターが処理された行数を表示します。完了すると、サマリーメールが届きます。
50,000リンクの上限#
各インポート実行は50,000行に制限されています。ファイルがそれより大きい場合は、複数のファイルに分割して順次実行してください。インポート実行の1日の制限はありません。
重複排除#
インポーターは既存のリンクに対してスラッグを確認します。行のスラッグがワークスペースに既に存在する場合：
- 行はエラー（「slug already taken」）でスキップされます。
- 既存のリンクは変更されません。
スラッグ列が空白の場合、常に新しい一意のコードを生成するため、スラッグが空白の行は決して競合しません。
部分的に処理したファイルを再インポートする場合、インポーターはスラッグが空白の行に対してべき等です（各実行は新しいコードで新しいリンクを作成します）。明示的なスラッグの場合、ワークスペースにまだ存在しないスラッグの行のみが成功します。
よくあるインポートエラーと修正方法#
「Invalid URL」 — 宛先にスキーム（https://）が含まれていないか、URLとして有効でない文字が含まれています。スプレッドシートのセルを修正して再アップロードしてください。
「Slug already taken」 — そのスラッグを持つリンクが存在します。自動生成されるものを取得するためにスラッグを削除するか、ユニークなものに変更してください。
「Slug contains invalid characters」 — スラッグには文字（a-z、A-Z）、数字（0-9）、ハイフン（-）のみが使用できます。スペース、アンダースコア、ドットは使用できません。
「File too large」 — ファイルが50,000行の上限を超えています。分割してバッチでインポートしてください。
「Destination blocked」 — URLスキャナーが宛先を悪意のあるものまたはブロックされたカテゴリとしてフラグ立てしました。これが誤検知だと思う場合は、URLを添えてサポートに連絡してください。
トラブルシューティング#
インポートが完了したが一部の行が見つからない。 インポートレポートをダウンロードしてください — インポートサマリーにリンクが表示されます。レポートにはどの行がスキップされたかとその理由が表示されます。ほとんどのスキップは重複するスラッグまたは無効なURLです。
インポーターがファイルが不正形式と言っている。 ファイルが実際にCSVであることを確認してください（TSVやExcelの.xlsxではなく）。テキストエディターで開き、カンマが区切り文字であり、ヘッダー行が存在することを確認してください。
インポートが「processing」で止まっている。 大きなインポート（数万行）には数分かかる場合があります。ページを更新して現在のステータスを確認してください。10分後もまだ止まっている場合は、URLに表示されているインポートIDを添えてサポートに連絡してください。