一括アップロードガイド

大規模なカタログを持つレーベルにとって、一括アップロードツールは大きな時間の節約になります。LabelGridでは、複数のリリースをアップロードする方法として、API連携とDDEXインポートの2つに対応しています。

一括アップロードの方法

利用できる選択肢

方法	適した用途	必要なプラン
API連携	自動化されたワークフロー、独自の連携	APIアクセスが有効なプラン
DDEXインポート	業界標準のフィード、メジャーレーベルのワークフロー	エンタープライズ/APIプラン（サポートにお問い合わせください）

ノート

一括アップロードの方法は、APIアクセスが有効なプランで利用できます。ご利用のプランにAPIアクセスが含まれていない場合は、LabelGridのダッシュボードからリリースを個別に作成するか、サポートに連絡してAPIアクセスの有効化についてご相談ください。

---

API連携

概要

LabelGrid APIを使うと、リリースの作成や管理をプログラムから行えるため、大規模なカタログ向けに完全に自動化されたワークフローを構築できます。

できること

• プログラムからリリースを作成する
• API経由でオーディオファイルをアップロードする
• メタデータを一括で管理する
• 配信ワークフローを自動化する
• 既存のシステムと連携する

はじめ方

1. プランでAPIアクセスを有効にする（まだ有効になっていない場合はサポートにお問い合わせください）
2. アカウント設定でAPI認証情報を生成する
3. エンドポイントの詳細についてAPIドキュメントを確認する
4. 連携を実装する、または当社のSDKを利用する
5. 本番環境の前にステージング環境でテストする

リクエスト例

POST /api/public/releases
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "title": "Album Title",
  "type": "album",
  "primary_artist": "Artist Name",
  "release_date": "2024-03-15",
  "tracks": [
    {
      "title": "Track One",
      "track_number": 1,
      "isrc": "USRC12400001"
    }
  ]
}

以前のディストリビューターを記録する

すでに他社で公開済みのリリースを移行する場合、公開Releases APIには、移行元のディストリビューターを記録するための任意の transfer_from_distributor フィールド（自由記述、最大255文字）があります。このフィールドはリリースが配信されると読み取り専用になるため、送信前または送信時に設定してください。

APIのメリット

• 完全な自動化 - 手作業の介入は不要
• システム連携 - DAM、CRM、その他のツールと接続できる
• リリースの予約 - 将来の配信に向けてリリースをキューに入れられる
• 独自の検証 - 送信前にコンテンツを事前検証できる
• Webhook通知 - 配信ステータスの更新をリアルタイムで受け取れる
• エラー処理 - プログラムによるエラー検出と再試行

レート制限

APIにはシステムの安定性を確保するためのレート制限があります。現在のレート制限の詳細はAPIの概要をご覧ください。

完全なドキュメントはAPIの概要をご覧ください。

---

DDEXインポート

概要

DDEX（Digital Data Exchange）は、メジャーレーベルがディストリビューターへコンテンツを届ける際に用いる業界標準のフォーマットです。LabelGridは、すでにDDEX配信の仕組みを持つエンタープライズのお客様向けにDDEXインポートに対応しています。

DDEXとは

DDEXは、次の情報をひとまとめにするXMLベースの標準規格です。

• リリースのメタデータ
• トラック情報
• オーディオファイルの参照
• アートワークおよびアセット
• 契約条件と地域（テリトリー）

対応フォーマット

バージョン	ステータス
ERN 4.3.2	対応（推奨）
ERN 4.3.1	対応
ERN 4.3.0	対応
ERN 3.8.2	対応（旧バージョン）

DDEXの設定手順

1. サポートに連絡してDDEXの有効化を依頼します
2. 当社の技術チームとオンボーディングを完了します
3. 配信設定とファイルパスを構成します
4. 安全なファイル転送のためのSFTP認証情報を設定します
5. 検証のためのテスト配信を送信します
6. 承認され次第、本番配信を開始します

配信のワークフロー

あなたのシステム → DDEX XML + アセット → SFTPアップロード → LabelGridでの処理 → 配信

DDEXの要件

要件	詳細
プラン	APIアクセスが有効（サポートにお問い合わせください）
フォーマット	ERN 4.3.2 推奨（4.3.1、4.3.0、3.8.2 にも対応）
配信方法	SFTP のみ
アセット	オーディオファイルを同梱または参照
検証	事前検証を推奨

DDEXが適している場合

DDEXインポートは次のような場合に適しています。

• すでにDDEX配信の仕組みを持っている
• DDEXを使う別のディストリビューターから移行する
• コンテンツ管理システムがDDEXをそのまま書き出せる
• 確立されたワークフローを持つメジャーレーベルや大規模なインディペンデントである

代わりにAPIが適している場合

REST/JSON APIは次のような場合に適しています。

• 新しい連携をゼロから構築する
• XMLよりも最新のWeb APIを好む
• リアルタイムの双方向通信が必要
• Webhookベースの通知を使いたい

---

方法の選び方

観点	API連携	DDEXインポート
設定の複雑さ	低い	高い
既存の仕組み	新規に構築	既存のDDEXを利用
フォーマット	JSON	XML
配信方法	HTTPS	SFTP
リアルタイム更新	あり（Webhook）	ポーリングが必要
適した用途	新規の連携	エンタープライズの移行

---

処理時間

API またはDDEX経由でコンテンツをアップロードした後の処理時間は、次の要素によって変わります。

• リリース数とトラック数
• オーディオファイルのサイズ
• メタデータの複雑さ
• 現在のシステム負荷

大規模なカタログほど、当然ながら処理に時間がかかります。ご自身のカタログ規模における想定の所要時間について助言が必要な場合は、サポートにお問い合わせください。

---

大規模移行時の送信上限

ご利用のアカウントには、直近7日間のリリース送信数に上限が適用される場合があります。この上限が有効なとき、API経由やDDEXインポートで送信したリリースを含め、アカウント上のすべてのリリース送信がカウントされます。リリースの再送信もカウントの対象です。

一度に大規模なカタログ移行を計画していて、1週間に20件を超えるリリースを送信する見込みがある場合は、伴走型の作業として扱ってください。アップロードを始める前に、まずサポートにお問い合わせください。一緒に計画を立てさせていただきます。サポートでは移行向けに一時的な上限の免除期間を手配できますので、移行の途中で上限にぶつかるのではなく、開始前にご連絡ください。

すべてのトラックが取り込まれたか確認

一括インポートまたはDDEXインポートの後は、配信する前にすべてのトラックが正しく取り込まれたことを確認してください。

---

関連情報

大規模なカタログを管理していますか。LabelGridが規模が大きくなってもリリースをどのように整理して管理するのかについては、当社サイトのカタログ管理をご覧ください。

---

サポートが必要ですか

一括アップロードの設定でお困りの場合：

• API連携： APIの概要をご覧いただくか、サポートにお問い合わせください
• DDEXの有効化： ご要望を添えてサポートチームまでお問い合わせください

最適な方法を選び、設定をスムーズに進められるよう、当社チームがお手伝いします。