# LINE MUSIC Analytics カタログ定義書

# 目次

# カタログについて

カタログとは、LINE MUSICのトラックやビデオトラックなどの情報の一覧を記載したものです。 現在提供しているカタログは以下になります。

  • トラックカタログ
  • ビデオトラックカタログ

# 提供方法

カタログはCSV形式のファイルを含むZIPファイルとして提供されます。 APIを利用することでこのZIPファイルをダウンロードできるURLを発行することができます。 このURLには有効期限があり、URLの発行後3分間となります。 この有効期限を過ぎたURLからはダウンロードができなくなりますのでご注意ください。 有効期限を過ぎてしまった場合は、再度APIを利用して別のURLを発行し、ダウンロードしてください。

また、このZIPファイルはLMAのWeb UIからもダウンロードすることができますので、そちらもご活用ください。

# 最新データの反映について

毎日03：00~12：00に前日分のデータからカタログのファイルを作成いたします。 そのため、提供されるカタログは前々日、もしくは前日のデータとなります。 また、システム障害等でデータの作成が遅延し、時間が前後することがございますので予めご了承ください。

# 障害発生時の対応について

システム障害等により、データの作成が大幅に遅延する場合や、誤ったデータを提供してしまう可能性があります。 このような場合は、障害復旧後にお知らせとともに正しいデータを提供いたします。

# ファイル名

# エスケープについて

出力ファイルについては、以下のルールにてエスケープ処理を実施しています。

  • 全ての値は"（引用符）で囲まれます。
  • 値の中に記号"が含まれる場合は、""に置換されます。
  • 空（値が空白）の場合には、"NULL"に置き換えられます。
  • 値がNULLである場合には、"'NULL'"に置き換えます。

参考

  • 二重の"を使用したエスケープに対応していないCSVライブラリで読み込む場合は、事前に""を他の文字に置換してから読み込むことで、正しくparseすることができます。
  • 値にNULL以外が含まれている場合には置換されません。

(例)

値 表記
linemusic "linemusic"
line"music "line""music"
line""music "line""""music"
空（値が空白） "NULL"
NULL "'NULL'"
NULLsample "NULLsample"

# トラックカタログ

トラックカタログは全てのトラック情報の一覧です。 トラックカタログは以下の1つのCSVファイルで構成されています。

  • lm_tracks_[label_ex_id]_YYYYMMDD.csv

# lm_tracks_[label_ex_id]_YYYYMMDD.csv

No 項目名 説明
1 label_nm レーベル名
2 track_ex_id LINE MUSICでのトラックID
3 track_nm 曲名
4 universal_track_code トラックに紐付いたMSIN
5 isrc ISRC
6 label_track_code トラックに紐付いた品番
7 track_pkgid トラックに紐付いたパッケージ番号
8 track_artist_ex_id トラックに紐付いたLINE MUSICでのアーティストID
9 track_artist_nm トラックに紐付いたアーティスト名
10 track_universal_artist_code トラックに紐付いたMSAN
11 album_disc_no アルバムのディスク番号
12 album_track_no アルバム内の曲順
13 album_ex_id LINE MUSICでのアルバムID
14 album_nm アルバム名
15 universal_album_code アルバムに紐付いたMSIN
16 upc UPC/JAN/EAN
17 label_album_code アルバムに紐付いた品番
18 cdpno CD番号
19 album_pkgid アルバムに紐付いたパッケージ番号
20 album_artist_ex_id アルバムに紐付いたLINE MUSICでのアーティストID
21 album_artist_nm アルバムに紐付いたアーティスト名
22 album_universal_artist_code アルバムに紐付いたMSAN
23 public_started 配信開始日
24 public_ended 配信終了日
25 dl_public_started アラカルト販売開始日
26 dl_public_ended アラカルト販売終了日
27 dl_price アラカルト販売価格
28 lm_display LINE MUSIC表示有無
29 display_released サービス表示開始日
30 dt 日付

# ビデオトラックカタログ

ビデオトラックカタログは全てのビデオトラック情報の一覧です。 ビデオトラックカタログは以下の1つのCSVファイルで構成されています。

  • lm_videos_[label_ex_id]_YYYYMMDD.csv

# lm_videos_[label_ex_id]_YYYYMMDD.csv

No 項目名 説明
1 label_nm レーベル名
2 video_ex_id LINE MUSICでのビデオトラックID
3 video_nm ビデオトラック名
4 universal_video_code ビデオトラックに紐付いたMSIN
5 isrc ISRC
6 label_video_code ビデオトラックに紐付いた品番
7 video_artist_ex_id ビデオトラックに紐付いたLINE MUSICでのアーティストID
8 video_artist_nm ビデオトラックに紐付いたアーティスト名
9 video_universal_artist_code ビデオトラックに紐付いたMSAN
10 album_ex_id LINE MUSICでのアルバムID
11 album_nm アルバム名
12 universal_album_code アルバムに紐付いたMSIN
13 upc UPC/JAN/EAN
14 label_album_code アルバムに紐付いた品番
15 cdpno CD番号
16 album_artist_ex_id アルバムに紐付いたLINE MUSICでのアーティストID
17 album_artist_nm アルバムに紐付いたアーティスト名
18 album_universal_artist_code アルバムに紐付いたMSAN
19 public_started 配信開始日
20 public_ended 配信終了日
21 lm_display LINE MUSIC表示有無
22 display_released サービス表示開始日
23 dt 日付