2025年5月17日以降、Printfulでは一部のインクジェットプリント（DTG）商品で、 より大きい標準前面印刷範囲 15″ × 18″ を提供しています。これにより、ストアに より大きく大胆なデザインを取り入れることができます。このガイドでは、 API連携をこの標準に接続する方法を 説明します。
APIではどの配置名を使うべきですか？
15″ × 18″ の印刷範囲を利用するには、API呼び出しで 配置名 front_large を使用する必要があります。従来の配置名である front は、Printfulカタログでの新規商品の作成では 段階的に廃止されましたが、移行前に作成された既存商品では引き続き有効です。
この変更は商品にどのような影響がありますか？
まず、この変更が新規商品と既存商品にどのような影響を与えるかを確認してください。
既存商品について:
- すぐに対応する必要はありません。 現在 front 配置を使用している商品は 引き続き販売でき、注文も通常どおり処理されます。
-
既存商品を編集すると、システムにより配置が自動的に
front_largeに更新されます。その時点で、より大きい 15" x 18" の範囲でもデザインがきれいに見えるよう、 拡大率と解像度（DPI）を確認してください。 - アップグレードは任意です。 既存商品でより大きい印刷範囲を使用したい場合は、 商品の配置情報を更新するだけで大丈夫です。
新しく作成する商品について:
- 2025年5月17日以降、前面プリントのあるすべての新規商品では 必ず
front_largeを使用する必要があります。 対象商品では、front 配置はPrintfulカタログで利用できなくなります。
API呼び出しを更新する
次に、新しい配置名 front_large をコード内のどこに実装するかを把握する必要があります。 新しい配置名が利用可能かどうかは、カタログ内の特定の商品を呼び出すことで確認できます。
-
API V1 では、以下を確認してください:
Result > Product > Files > Type -
API V2 では、以下を確認してください:
Data > Placements
APIリクエストで front_large を使用する場所は次のとおりです。
API V1 実装:
-
新しい Sync Product を作成するには: リクエスト本文の
Sync_variants > Files > Typeに配置を指定します -
新しい注文を作成するには: リクエスト本文の
Items > Files > Typeに配置を指定します -
モックアップ生成タスクを作成するには: リクエスト本文の
Files > Placementに配置を指定します
API V2 実装:
-
新しい注文を作成するには: リクエスト本文の
Order_items > Placements > Placementに配置を指定します -
モックアップを作成するには: リクエスト本文の
Products > Placements > Placementに配置を指定します
これらの手順に従えば、API連携は新しいより大きなDTG印刷配置への 切り替えに完全に対応できます。