API連携を15″ × 18″の印刷範囲に切り替える方法

2025年5月17日より、Printfulでは一部のDTG（インクジェットプリント）製品で、標準の前面プリント範囲を15″ × 18″に拡大しました。これにより、より大きく大胆なデザインをショップに取り入れられます。このガイドでは、API連携をこの標準仕様に接続する方法をご説明します。

APIではどの配置名を使用すればよいですか？

15″ × 18″の印刷範囲を利用するには、APIリクエストで配置名front_largeを使用する必要があります。従来の配置名frontは、Printfulカタログでの新製品作成には使用されなくなりましたが、切り替え前に作成された既存の商品では引き続き有効です。

この変更は商品にどのような影響がありますか？

まず、この変更が新規商品と既存商品にどのような影響を与えるかを確認しましょう。 

既存の商品について： 

• すぐに必要な対応はありません。前面配置を使用している現在の商品は引き続き販売でき、注文も通常どおり処理されます。
• 既存の商品を編集すると、システムによって配置が自動的にfront_largeに更新されます。その際は、より大きな15" x 18"の範囲できれいに表示されるよう、オリジナルデザインの拡大縮小と解像度（DPI）を確認してください。
• アップグレードは任意です。既存商品に大きな印刷範囲を使用したい場合は、商品の配置情報を更新してください。 

作成する新製品について： 

• 2025年5月17日以降、前面プリントを使用するすべての新製品には、front_largeを使用する必要があります。対象製品では、Printfulカタログで前面配置を選択できなくなります。 

APIリクエストを更新する

次に、コード内のどこで新しいfront_large配置名を使用するかを確認します。カタログから特定の商品を呼び出すことで、新しい配置名が利用可能か確認できます。 

• API V1では、次の項目を確認してください：Result > Product > Files > Type
• API V2では、次の項目を確認してください：Data > Placements 

APIリクエストでfront_largeを使用する場所は次のとおりです。 

API V1の実装： 

• 新しい同期商品を作成するには：リクエスト本文のSync_variants > Files > Typeで配置を指定します。
• 新しい注文を作成するには： リクエスト本文のItems > Files > Typeで配置を指定します。
• モックアップ生成タスクを作成するには： リクエスト本文のFiles > Placementで配置を指定します。

API V2の実装： 

• 新しい注文を作成するには： リクエスト本文のOrder_items > Placements > Placementで配置を指定します。
• モックアップを作成するには：リクエスト本文のProducts > Placements > Placementで配置を指定します。 

これらの手順に従うことで、新しい、より大きなDTGプリント配置への切り替えに向けて、API連携を完全に準備できます。 

プリント配置の変更と対象商品について詳しくはこちら