この記事では、Gelato API を使用する際の製品 UID（unique identifier／一意識別子）の意味と重要性を説明します。製品 UID の構造を分解し、各要素とその役割を明確な例で示し、印刷注文の詳細指定にどう関わるかを解説します。製品 UID を理解することは、Gelato API 経由で送信される印刷ジョブについて、フォーマットや用紙種類を正しくマッピングするうえで不可欠です。製品 UID の完全な一覧は、API ポータルの製品カタログで確認できます。
製品UIDの理解
製品のUIDは、各プリント製品を一意に識別するための総合的なIDです。複数の属性を組み合わせて、あなたの仕様どおりにプリントジョブが実行されるようにします。主な構成要素を見ていきましょう。
これらのパーツは、各製品で必須です（例：フラットなフォーマットには「製本タイプ」はありません）。
商品カテゴリ
UIDの最初の部分は商品のカテゴリを示します。例："カード"、"チラシ"、"パンフレット"など。
例:
カード_pf_bb_pt_350-g_コート_シルク_cl_4-0_ct_マット保護_prt_1-1_hor
パンフレット_pf_a4_pt_350-g_コート-シルク_cl_4-4_ft_fold-ver_ct_光沢保護_prt_1-1_ver
用紙サイズ
pf は用紙フォーマットです。例：「bb」や "A4"
例:
cards_pf_bb_pt_350-g-コート-シルク_cl_4-0_ct_マット保護_prt_1-1_hor
brochures_pf_a4_pt_350-g_コート-シルク_cl_4-4_ft_fold-ver_ct_光沢保護_prt_1-1_ver
用紙の規格と寸法の詳細は、こちらをご覧ください。
用紙タイプ
pt は用紙タイプです。例：「350-g-コート-シルク」または「130-lb-cover-コート-シルク」
例:
cards_pf_bb_pt_350-g_コート-シルク_cl_4-0_ct_マット保護_prt_1-1_hor
brochures_pf_a4_pt_130-lb-cover-コート-silk_cl_4-4_ft_fold-ver_ct_光沢保護_prt_1-1_ver
複数ページの商品では、この属性は中ページの用紙タイプを示します。表紙の用紙タイプは属性 cpt で指定します。また、北米では標準として「lb」が使われ、それ以外の地域では「g」が使われます。
印刷面
cl はカラーの面を示します。例：「4-4」（両面印刷）または「4-0」（片面印刷）
例:
cards_pf_bb_pt_350-g-コート-シルク_cl_4-0_hor
brochures_pf_a4_pt_350-g-coated-silk_cl_4-4_ft_fold-ver_ver
製本の種類
bt は製本の種類を示します。例："glued-left"（左側の無線綴じ）、"wire-o-left"（左側のリング綴じ製本）、"stitched-left"（左側の中綴じ）
例:
glued-multi-page-brochures_pf_a4_pt_100-lb-text-コート-silk_cl_4-4_bt_glued-left_cpt_100-lb-cover-コート-silk_hor
リング綴じ製本-マルチページ-パンフレット_pf_a5_pt_100-lb-テキスト-コート-シルク_cl_4-4_bt_リング綴じ製本-左_cpt_130-lb-カバー-コート-シルク_ver
stitched-multi-page-brochures_pf_a5_pt_170-g_コート-silk_cl_4-4_bt_stitched-left_ct_glossy-protection_prt_1-1_cpt_250-g_コート-silk_ver
この属性は、複数ページの製品にのみ適用されます。
表紙用紙の種類
cpt は表紙用紙の種類を表します。例：「100-lb-cover-coated-silk」や「250-g-コート-silk」
例:
glued-multi-page-brochures_pf_a4_pt_100-lb-text-coated-silk_cl_4-4_bt_glued-left_cpt_100-lb-cover-coated-silk_hor
wire-o-multi-page-brochures_pf_a5_pt_100-lb-text-coated-silk_cl_4-4_bt_wire-o-left_cpt_130-lb-cover-coated-silk_ver
stitched-multi-page-brochures_pf_a5_pt_170-g-コート-シルク_cl_4-4_bt_stitched-left_ct_グロッシー-プロテクション_prt_1-1_cpt_250-g-コート-シルク_ver
折り方の種類
ft は折りの種類（ある場合）を表します。例："fold-ver"（単折り・縦）、"fold-hor"（単折り・横）、"8pp-roll-fold-ver"（8 回折り・縦）、"three-fold-hor"（三つ折り・横）
例:
brochures_pf_a4_pt_350-g-コート-シルク_cl_4-4_ft_fold-ver_ct_グロッシー保護_prt_1-1_ver
three-fold-brochures_pf_a4_pt_100-lb-cover-コート-silk_cl_4-4_ft_three-fold-ver_ct_グロッシー-protection_ver
この属性は、折り加工された製品にのみ適用されます。
コーティングの種類
ct はコートの種類（ある場合）。例："glossy-protection" または "matt-protection"
例:
cards_pf_bb_pt_350-gコート-silk_cl_4-0_ct_マット-protection_prt_1-1_hor
brochures_pf_a4_pt_350gコートシルク_cl_4-4_ft_fold-ver_ct_光沢保護_prt_1-1_ver
コーティングの詳細については、こちらをご覧ください。
保護サイド
prt は保護面を示します。例：「1-1」（両面に保護）や「1-0」（片面のみ保護）
例:
cards_pf_bb_pt_350-g_coated-silk_cl_4-0_ct_matt-protection_prt_1-1_hor
brochures_pf_a4_pt_350-g_コート-シルク_cl_4-4_ft_巻き折り_ct_光沢保護_prt_1-0_ver
複数ページの商品の場合、この属性は表紙ページにのみ適用されます。
[#$tu147]
hor/ver はデザインの向きで、たとえば縦向きや横向きのことです
例:
cards_pf_bb_pt_350-g_coated-silk_cl_4-0_ct_matt-protection_prt_1-1_hor
brochures_pf_a4_pt_350-g-コート-シルク_cl_4-4_ft_折り-ver_ct_光沢保護_prt_1-1_ver
APIポータルからプロダクトカタログにアクセスすると、サポート対象のすべての商品の UID を確認できます。
複数ページの製品の場合、ページ数は製品の UID に含めず、属性として別途送信してください。詳しくはこちらをご覧ください。
プリント範囲（アパレル製品）
4-0 （表面に印刷） ; 0-4（裏面に印刷） , 4-4（表裏に印刷）
例:
apparel_product_gca_Ｔシャツ_gsc_クルーネック_gcu_ユニセックス_gqa_ヘビーウェイト_gsi_S_gco_ホワイト_gpr_4-0
ユニセックス厚手クルーネックTシャツ、S、ホワイト、前面プリント（4-0）アパレル_製品_gca_t-shirt_gsc_クルーネック_gcu_ユニセックス_gqa_ヘビーウェイト_gsi_s_gco_ホワイト_gpr_0-4
ユニセックス厚手クルーネックTシャツ、S、ホワイト、背面プリント（0-4）apparel_product_gca_Ｔシャツ_gsc_クルーネック_gcu_ユニセックス_gqa_ヘビーウェイト_gsi_S_gco_ホワイト_gpr_4-4
ユニセックス厚手クルーネックTシャツ、S、ホワイト、前面＋背面にプリント（4-4）
プリント領域（特定のアパレル製品で利用可能）:
内側ラベル（inLbl）
外側ラベル（bckLbl）
半袖 左 (shSlL)
半袖右 (shSlR)
例:
apparel_product_gca_t-shirt_gsc_crewneck_gcu_unisex_gqa_heavy-weight_gsi_s_gco_white_gpr_4-4_inlbl
ユニセックス厚手クルーネックTシャツ、S、ホワイト、前面＋背面＋内側ラベルにプリントアパレル_商品_GCA_Tシャツ_GSC_クルーネック_GCU_ユニセックス_GQA_ヘビーウェイト_GSI_S_GCO_ホワイト_GPR_4-4_BCKLBL
ユニセックス厚手クルーネックTシャツ、S、ホワイト、前面＋背面＋背面ラベルにプリントapparel_product_gca_t-shirt_gsc_crewneck_gcu_unisex_gqa_heavy-weight_gsi_s_gco_white_gpr_4-4_shsll
ユニセックス厚手クルーネックTシャツ、S、ホワイト、前面＋背面＋左袖にプリントapparel_product_gca_t-shirt_gsc_crewneck_gcu_unisex_gqa_heavy-weight_gsi_s_gco_white_gpr_4-4_shslr
ユニセックス厚手クルーネックTシャツ、S、ホワイト、前面＋背面＋右袖にプリントapparel_product_gca_t-shirt_gsc_crewneck_gcu_unisex_gqa_heavy-weight_gsi_s_gco_white_gpr_4-4_shsll_shslr_inlbl
ユニセックス厚手クルーネックTシャツ、S、ホワイト、前面＋背面＋左右の半袖＋内側ラベルにプリントapparel_product_gca_t-shirt_gsc_crewneck_gcu_unisex_gqa_heavy-weight_gsi_s_gco_white_gpr_4-0_shsll_shslr_bcklbl
ユニセックス厚手クルーネックTシャツ、S、ホワイト、前面プリント＋左右の半袖＋外側の首ラベル
刺繍
すべての刺繍UIDは「emb」で終わります。例:
apparel_product_gca_t-shirt_gsc_crewneck_gcu_womens_gqa_classic_gsi_s_gco_white_gpr_chstc-刺繍
apparel_product_gca_hoodie_gsc_pullover_gcu_unisex_gqa_classic_gsi_s_gco_white_gpr_chstc-刺繍
DTGプリント（ダイレクト・ツー・ガーメント）のアパレルのUIDと同様に、刺繍の対応エリアは次のとおりです。
胸の中央 (chstc)
大きな胸 (chstlg)
左胸 (chstl)
右手首 (wrstr)
左手首 (wrstl)
半袖 右 (shslr)
半袖 左 (shsll)
内側タグや外側タグを自分でデザインすると、商品のブランディングに役立ちます。対象のアパレル製品では、内側または外側どちらかのタグを印刷できます（同じ衣服に両方は不可）。また、外側タグの印刷は背面への印刷と併用できません。内側・外側タグに対応しているアパレル製品は、この記事で一覧できます。