最終更新日: 2025年8月22日
Run in Postman
製品を作成する
製品を作成するには、POST
リクエストをcrm/v3/objects/products
に送信します。リクエスト本文に、作成時に設定する製品プロパティーを含むproperties
オブジェクトを含めます。後から同じエンドポイントにPATCH
リクエストを送信することで、製品のプロパティーを更新できます。
利用可能な全ての製品プロパティーを表示するには、プロパティーAPIにGET
リクエストを送信します。製品プロパティーを取得する場合のリクエストURLは/crm/v3/properties/products
になります。
hs_recurring_billing_period
の値はP#M
という形式(# は月数)であることに注意してください。製品を関連付ける
製品自体を他のCRMオブジェクトに関連付けることはできません。ただし、製品の情報を取引または見積もりに関連付けるために、その製品に基づく商品項目を作成できます。商品項目は製品の個々のインスタンスであり、製品とは別のオブジェクトであるため、製品自体を更新することなく、必要に応じて取引や見積もりで商品やサービスを調整できます。 例えば、いずれか1つの製品が販売される取引をまとめるときには、まず製品から商品項目を作成し、それを取引に関連付けます。商品項目の作成と関連付けは、2つの別々の呼び出しで行うことも、1つの呼び出しで行うこともできます。両方のオプションを以下に示します。注:
商品項目は、1つの単一親オブジェクトに属します。オブジェクトを関連付ける場合、商品項目はラインアイテムはオブジェクトごとに個別にする必要があります。例えば取引と見積もりを作成する場合は、取引用に1つの商品項目セットを作成し、見積もり用に別の商品項目セットを作成する必要があります。これは、オブジェクト間でCRMデータを合理化し、商品項目を変更する必要があるときに予期しないデータ損失が発生しないようにするためです。例えば、見積もりを削除すると、見積もりの商品項目も削除されます。それらの商品項目が取引に関連付けられている場合、取引の商品項目も削除されます。商品項目を作成して関連付ける(複数の呼び出し)
まず、IDが1234567
である製品に基づいて商品項目を作成します。利用可能な商品項目プロパティー全てのリストを取得するには、プロパティーAPIにGET
リクエストを送信します。商品項目のURLはcrm/v3/properties/line_items
となります。既存の製品から商品項目を作成しているため、その製品から価格などのプロパティー値を継承します。
7791176460
であると仮定します。
商品項目を既存の取引(ID:14795354663
)に関連付けるには、PUT
リクエストを/crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663
に送信します。このリクエストでは、デフォルトの関連付けタイプを使用します。
200
レスポンスで、以下のような情報が返されます。

商品項目を作成して関連付ける(単一の呼び出し)
単一の呼び出しを使用して既存の製品から商品項目を作成し、取引に関連付けるには、商品項目の作成リクエストにassociations
配列を含めます。
商品項目を作成するには、POST
リクエストをcrm/v3/objects/line_item
に送信します。リクエスト本文は以下のようになります。商品項目と取引の関連付けのassociationTypeId
は20
であることに注意してください。詳しくは、さまざまなタイプのCRMレコード間の関連付けタイプをご確認ください。
200
レスポンスで、新しい商品項目の詳細が返されます。HubSpotでは、取引レコードの商品項目カードに「商品項目」が表示されます。
