コンテンツDBの使い方 — テーブル作成からレコード管理・Webサイト連携まで

サイドバーの「コンテンツDB」をクリックすると、テーブル一覧が開きます。

テーブル一覧には、作成済みのテーブルが1行ずつ並びます。「下書き」「承認待ち」「公開中」「終了」の各列はそのテーブルのレコード件数で、Webサイトに表示中の件数（公開中）と準備中・掲載終了の件数がひと目で分かります。例の「店舗一覧」テーブルは、下書き 2 件・公開中 26 件・終了 2 件の合計 30 件です。

一覧は20件ごとにページ分けされます。

画面右上の「新規作成」をクリックすると「テーブル作成」ダイアログが開きます。上部の切り替えで「CSVから作成」（初期選択）と「手動で作成」を選べます。「CSVから作成」は「1 データ選択 → 2 項目設定 → 3 確認」の3ステップで進みます。

「1行目を見出し行としたCSVファイルをアップロードしてください。列ごとに項目の候補を提案します。」の案内に従い、「ファイルを選択」でCSVを選びます。ファイル名が表示されたら「解析する」をクリックしてください。

解析が終わると、CSVの列が1行ずつ並び、列の内容から判定した項目タイプが提案されます。ここがCSV取込のいちばん大切なステップです。

先頭の id 行は自動採番のレコードIDで、「自動採番（CSV出力・公開APIの先頭列）」と表示されます。画面上部の案内もあわせて確認してください。

• 取り込む列にチェックを入れ、項目キーとタイプを確認してください
• タイプで「名前 [システム]」を選んだ列がレコードの名前になります
• レコードID（id）は自動で付与され、CSV出力と公開APIの先頭列になります

タイプの提案ルールは次のとおりです。列の内容だけで判定するため、意図と違う場合はプルダウンで直します。

店舗一覧の例では、次の4点を手で直します。

1. 1掲載状態の列のタイプを「掲載状態 [システム]」にする — 「下書き / 公開中 / 終了」の列は「選択（プルダウン）」と提案されるので、プルダウンから「掲載状態 [システム]」を選びます。こうすると、CSVの値がそのままレコードの掲載状態になります。この設定をしないと、確認ステップに「status キーの列がないため、すべて下書きとして取り込まれます」と表示され、全レコードが下書きで取り込まれます。
2. 2名前の列が「名前 [システム]」になっていることを確認する — 値がすべて異なる最初のテキスト列（例では「店舗名」）が自動で「名前 [システム]」になります。別の列を名前にしたい場合はプルダウンで選び直します。
3. 3提案が「近い」だけの列のタイプを直す — 営業時間（選択（プルダウン） → テキスト入力）、電話番号（テキスト入力 → 電話番号）、メールアドレス（テキスト入力 → メールアドレス）、予約（選択（プルダウン） → 選択（ラジオボタン））、オープン日（テキスト入力 → 日付選択）、公式サイト（テキスト入力 → URL入力）、店舗からのお知らせ（テキスト入力 → 複数行テキスト）。| 区切りの「設備」は「複数選択」と提案されるので、そのままで構いません。
4. 4項目キーを意味のある名前に書き換える — field_02 のような仮のキーを、Webサイトの制作担当者が読んで分かる英語のキーにします。

項目キーのルールは、半角英小文字・数字・_ のみ、50文字以内、テーブル内で重複なし、id・name・status は使用不可です。選択（プルダウン）の選択肢はファイル内の値の種類から自動で作られます（最大20件。超える場合は「選択肢が20件を超えるため選択タイプにできません。」と表示されるので、テキスト入力に変更してください）。

「『店舗一覧』に 15 項目を作成し、30 行を取り込みます」のように、作成される項目数と取り込む行数が表示されます。「名前」「掲載状態」に割り当てた列と、各項目のキー・タイプを確認してください。取込のチェックを外した列がある場合は「取り込まれない列:」として一覧されます。

「作成して取込」をクリックすると、「テーブルを作成し、取込を開始しました。処理状況は取込履歴で確認できます。」と表示され、作成したテーブルのレコード一覧に移動します。取込が終わると「取込が完了しました（作成 30 / 更新 0 / エラー 0）」の通知が表示されます。

CSVがない場合は「新規作成」→「手動で作成」で、テーブル名だけを入力して「作成」をクリックします（案内：「コンテンツの種類ごとに1つのテーブルを作成します」「作成後に項目を設定します」）。項目が0件のテーブル編集画面が開くので、3-2以降の手順で項目を追加します。

テーブル一覧の「テーブル編集」（歯車）アイコンをクリックすると、テーブル編集画面が開きます。上部でテーブル名と説明（1000文字まで。「用途やデータの出所などのメモ」）、レコードの名前と自動終了の設定を編集し、「コンテンツ項目設定」で項目を管理します（最大50件）。

「項目を追加」で新しい項目の行が増えます（50件に達すると「項目の上限数に達しました」となり追加できません）。編集が終わったら画面下の「保存」をクリックしてください。「テーブルを更新しました」と表示されます。

タイトルの横にあるアイコンから、タイプごとの詳細を設定できます。

選択肢の編集（鉛筆アイコン） — 選択（プルダウン）・選択（ラジオボタン）・複数選択で表示されます。選択肢を1行ずつ編集し、ドラッグで並び替え、「選択肢を追加」で増やせます（100件まで）。

設定（歯車アイコン） — テキスト入力・複数行テキスト・数値入力・日付選択で表示されます。

店舗一覧の例では「席数」の設定を、単位「席」・後に表示・カンマ区切りを非表示にする、にしました。レコードの入力欄に「席」が表示され、入力の目安になります。

• 複製 — テーブル一覧の「複製」アイコンで、「{テーブル名} (コピー)」という名前のテーブルが作られます。項目と選択肢はコピーされますが、レコードはコピーされません。「テーブルを複製しました」と表示されます。同じ項目構成のテーブルを増やしたいときに使います。
• 削除 — 「削除」アイコンをクリックすると「『{テーブル名}』を削除してよろしいですか？」と確認されます。レコードが残っているテーブルは「レコードが存在するため削除できません。先にレコードを削除してください。」となるので、先にレコード一覧で全件を削除してください。パブリッシャー登録ページの登録先になっているテーブルも削除できません。先に登録ページを削除してください。

テーブル一覧の「レコード一覧」アイコンをクリックすると、テーブル名をタイトルにしたレコード一覧が開きます。列は「名前」（テーブル編集で「名前の表示名」を設定した場合はその名前）「掲載状態」に続いて項目がテーブル編集の順に並び、右端に「登録日時」「更新日時」と編集・削除のアイコンがあります。

一覧は15件ごとにページ分けされ、画面下の件数（15 / 30 / 50 / 100）で変更できます。

「新規作成」をクリックすると「レコード作成」ダイアログが開きます。「名前」（必須、255文字まで）と各項目を入力し、上部の「アクション」で「下書きとして保存」「公開中として保存」「終了として保存」のいずれかを選びます。右下のボタンが選んだアクションの名前に変わるので、クリックすると「レコードを作成しました」と表示されます。アクションを選ぶまで、右下のボタンはクリックできません。

登録済みのレコードは、行の「編集」（鉛筆）アイコンから「レコード編集」ダイアログを開きます。ダイアログには「概要」「編集」の2つのタブがあり、編集アイコンから開くと「編集」タブが表示されます。項目を変更し、同じように「アクション」を選んで保存すると「レコードを更新しました」と表示されます。「概要」タブでは登録内容を一覧で確認できます（アクションは「編集」タブで選びます）。

アクションの横の「変更の理由・コメント」に入力した内容は、変更履歴に残ります（4-3）。例では、オープン前の「サンプルカフェ 川崎店」（下書き）を開き、「アクション」で「公開中として保存」を選んでいます。見出しの「下書き → 公開中」で、保存後の掲載状態を確認できます。

「レコード編集」ダイアログの右上にある「変更履歴」をクリックすると、そのレコードの掲載状態の変更、操作した人、コメントが新しい順に表示されます。操作した人は、オーナー・管理者の操作は「管理者」、パブリッシャーの操作は「パブリッシャー: 氏名」、自動終了などによる変更は「システム」と表示されます。項目を編集した履歴は「変更内容（N項目）」を開くと、「変更前」「変更後」を比べて確認できます。例では、「店舗からのお知らせ」に駐車場の案内を追記し、コメント「駐車場の案内を追記」を残して下書きのまま保存した履歴が表示されています。

行の「削除」（ゴミ箱）アイコンをクリックし、確認ダイアログで削除すると「レコードを削除しました」と表示されます。削除したレコードは元に戻せません。

店舗一覧の例では、新店舗を「下書き」で準備しておき、オープン日に「公開中」へ切り替えます。閉店した店舗は「終了」にすれば、データを残したまま表示から外せます。

テーブル編集で「自動終了の基準日」を設定したテーブルでは、公開中のレコードが基準日の翌日に自動で「終了」になります（3-2）。開催日を過ぎたイベントを手で終了にする必要はありません。

行の「編集」アイコンでレコード編集ダイアログを開き、「アクション」で「下書きとして保存」「公開中として保存」「終了として保存」から変更後の掲載状態を選んで、右下のボタンをクリックします。現在と違う掲載状態を選ぶと、ダイアログの見出しに「下書き → 公開中」のように変更後の掲載状態が表示されます（4-2の画面）。

行のチェックボックスにチェックを入れると、一覧の上に「{N}件選択中」と「掲載状態変更」「削除」「CSV出力」のボタンが表示されます。「全て選択」は表示中のページの全行を選択します。チェックを外すと選択をやめます。

例では、「下書き」で絞り込んでから「全て選択」し、オープン日を迎えた店舗をまとめて公開します。

「掲載状態変更」をクリックすると「選択した{N}件の掲載状態を変更します。」のダイアログが開きます。掲載状態は最初は選ばれていない（「選択してください」）ので、変更後の掲載状態（下書き・公開中・終了）を選んで「変更」をクリックします。「{N}件の掲載状態を「公開中」に変更しました」と表示されます。

「削除」をクリックすると「{N}件のレコードを削除します。この操作は取り消せません。」の確認ダイアログが開きます。

絞り込み結果が1ページに収まらないとき（例: 「公開中」26件を15件ずつ表示）は、「全て選択」をチェックしても選ばれるのは表示中の15件だけです。この状態で「掲載状態変更」「削除」「CSV出力」のいずれかをクリックすると、ダイアログの先頭に「対象」が表示され、「選択したレコード（15件）」と「絞り込み結果すべて（26件）」から選べます。

「絞り込み結果すべて（26件）」を選んで実行すると、ページをまたいだ絞り込み結果の全件に適用されます。「対象」は、選択した件数が絞り込み結果の全件と同じときは表示されません。

レコードをCSVファイルに出力するボタンは、2か所にあります。どちらも「CSV出力」ダイアログで「ダウンロード」をクリックすると、content_records_{日時}.csv がダウンロードされます。

• 一覧右上の「CSV出力」 — レコードを選ばなくても、いまの絞り込み結果（検索キーワードや掲載状態の絞り込み）をすべて出力します。ダイアログには「絞り込み結果{N}件をCSV出力します。」と表示されます。
• 一括操作の「CSV出力」 — チェックを入れた行を出力します（表示中のページをまとめて選ぶには「全て選択」）。絞り込み結果が複数ページにわたるときは「対象」で「絞り込み結果すべて（N件）」を選べます（5-4）。

列は id, name, status に続いて項目キーが並びます。status は draft / active / finished（パブリッシャーが申請中のレコードは unapproved）、チェックボックスは 1 / 0 で出力されます。文字コードはUTF-8です。「パブリッシャー権限」をご利用の場合は、最後に「パブリッシャー名」「パブリッシャーメールアドレス」の列が加わります（確認用の列で、CSV取込では無視されます）。

レコード一覧の「CSV取込」をクリックすると「CSV取込」ダイアログが開きます。「id列があれば更新、空欄なら新規作成します。取込後は結果ファイルで発行されたIDを確認できます。」の案内のとおり、id の有無で新規作成と更新を切り替えます。「CSVファイルを選択」でファイルを選ぶと、すぐに取込が始まります。

取込のルールは次のとおりです。

• id に値がある行は更新、空欄または id 列がない行は新規作成です（id はそのテーブルのレコードのものに限ります）。
• 新規作成で status が空欄の行は下書きになります。
• CSVにある列だけが書き込まれます。一部の項目だけを更新したい場合は、id とその列だけのCSVで構いません。
• 項目キーに一致しない見出しの列は無視されます。
• name は各行で必須です。
• 全行を先に検証し、エラーのある行だけを飛ばしてほかの行を取り込みます。1回の取込は1つの処理としてまとめて書き込まれます。
• 同じテーブルで同時に実行できる取込は1つです（「取込処理中のファイルがあります。完了後に再度お試しください。」）。
• ファイルはUTF-8（Shift_JISも可）、10MBまでです。
• CSV出力で値の先頭に付いた「'」は、取込時に自動で取り除かれます（6-1）。

「CSV取込」ダイアログの下部に、最近10件の取込履歴が表示されます。

例では、CSV出力したファイルのうち新宿店（営業時間）と渋谷店（店舗からのお知らせ）の2行を書き換え、横浜店の行は id を誤った値にした3行のCSV「店舗一覧_更新.csv」を取り込みました。結果は「作成 0 / 更新 2 / エラー 1」で、横浜店の行だけが「ID「…」のレコードが見つかりません。」として飛ばされています。

取込中はレコード一覧に「CSVを取込中です。完了すると自動で通知されます。」、完了すると「取込が完了しました（作成 N / 更新 N / エラー N）」が表示されます。エラーがある場合は通知に「結果ファイルをダウンロード」のリンクが付きます。「再読み込み」で一覧を最新の状態にします。

結果ファイル（{ファイル名}_result.csv）は、取り込んだCSVに id（新規作成された行は発行されたID）と result 列を加えたものです。result には行ごとに 作成 / 更新、またはエラーの内容が入ります。エラーの行だけを直して、もう一度取り込んでください。

行番号は見出し行を1行目として数えます（データの1行目は「2行目」）。

テーブル一覧の「公開APIのURL」（共有）アイコンをクリックすると、テーブル名をタイトルにしたダイアログに「レコード一覧」のURLが表示されます。右のボタンでコピーできます。「掲載状態が「公開中」のレコードのみ返されます。」の注記のとおり、下書き・承認待ち・終了のレコードはこのURLには含まれません。

URLは https://admin.ltag.tech/api/public/{チャネル識別子}/content-tables/{テーブルID}/records の形です。

• 読み取り専用のGETリクエストで、認証キーは不要です。このURLからデータを書き換えることはできません。
• per_page（1ページの件数。初期値100、最大500）と page で分割して取得できます。並び順は登録日時の新しい順です。
• 1件だけ取得する場合は …/records/{レコードID} です。
• アクセスは同じ接続元から1分あたり60回までです。

レスポンスの例（店舗一覧、per_page=1）:

{
  "data": [
    {
      "id": "01m17ggpdw8kavq7fqf3s46mj5",
      "name": "サンプルカフェ 新宿店",
      "created_at": "2026-08-30 04:39:02",
      "updated_at": "2026-08-30 04:47:51",
      "fields": {
        "prefecture": { "raw": "東京都", "display": "東京都" },
        "hours": { "raw": "7:00〜23:00", "display": "7:00〜23:00" },
        "closed_day": { "raw": "01m17geshtcjm9bgjtk0p1yaec", "display": "年中無休" },
        "seats": { "raw": "70", "display": "70席" },
        "has_parking": { "raw": false, "display": "いいえ" },
        "has_wifi": { "raw": true, "display": "はい" },
        "has_takeout": { "raw": true, "display": "はい" },
        "facilities": { "raw": ["01m17gesj76bn0tzzzahwqgty9", "01m17gesj93c0bgtgtr1psj0na"], "display": "テラス席、禁煙" },
        "address": { "raw": "新宿区新宿3-2-1 5F", "display": "新宿区新宿3-2-1 5F" },
        "phone": { "raw": "03-5678-9012", "display": "03-5678-9012" },
        "email": { "raw": "shop028@sample-cafe.example.com", "display": "shop028@sample-cafe.example.com" },
        "reservation": { "raw": "01m17gesjpgzm6x53qxgpwb07h", "display": "可" },
        "opened_on": { "raw": "2025-10-10", "display": "2025年10月10日" },
        "website": { "raw": "https://sample-cafe.example.com/shops/028/", "display": "https://sample-cafe.example.com/shops/028/" }
      }
    }
  ],
  "meta": { "current_page": 1, "last_page": 26, "per_page": 1, "total": 26 }
}

公開URLと、テーブルの項目キー一覧（CSV出力の見出し行がそのまま一覧になります）を制作担当者に渡してください。Webサイト側で公開URLを読み込んで一覧を表示する実装ができれば、以降はLタグでレコードを追加・編集・掲載状態の切り替えをするだけで、Webサイトの表示が更新されます。