> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.jp/docs/llms.txt > Use this file to discover all available pages before exploring further. # CRM API | 製品 export const postmanIcon = ; export const ScopesList = ({scopes = [], description = "この API には、次のいずれかのスコープが必要です。"}) => { if (!scopes || scopes.length === 0) { return null; } const sortedScopes = scopes.sort((a, b) => a.localeCompare(b)); return
{description}
{sortedScopes.map((scope, index) =>
{scope}
)}
; };
# 製品
HubSpotの製品は、販売する品物やサービスを表します。[製品ライブラリー](https://knowledge.hubspot.com/ja/products/create-and-manage-products)を構築すると、効率的に製品を取引に追加したり、見積もりを作成したり、製品の実績についてレポートを作成したりできます。製品エンドポイントを使用すると、製品データを管理したり、HubSpotと他のシステムとの間で同期したりできます。 製品は、会社、コンタクト、取引、チケット、商品項目、見積もりと同様にHubSpotのCRMツールのオブジェクトです。オブジェクトのプロパティー、関連付け、関係性などの詳細は、HubSpotの「[CRMオブジェクトについて](/guides/crm/understanding-the-crm)」のガイドをご覧ください。 **使用例**: 営業担当者が取引や見積もりなどに商品とサービスを簡単に追加できるように、製品APIを使用して製品カタログをHubSpotにインポートします。 ## 製品を作成する 製品を作成するには、`POST`リクエストを`crm/v3/objects/products`に送信します。リクエスト本文に、作成時に設定する製品プロパティーを含む`properties`オブジェクトを含めます。後から同じエンドポイントに`PATCH`リクエストを送信することで、製品のプロパティーを更新できます。 利用可能な全ての製品プロパティーを表示するには、[プロパティーAPI](/api-reference/crm-properties-v3/guide)に`GET`リクエストを送信します。製品プロパティーを取得する場合のリクエストURLは`/crm/v3/properties/products`になります。 ```json theme={null} { "properties": { "name": "Implementation Service", "price": "6000.00", "hs_sku": "123456", "description": "Onboarding service for data product", "hs_cost_of_goods_sold": "600.00", "hs_recurring_billing_period": "P12M" } } ``` `hs_recurring_billing_period`の値は`P#M`という形式（# は月数）であることに注意してください。 ## 製品を関連付ける 製品自体を他のCRMオブジェクトに関連付けることはできません。ただし、製品の情報を取引または見積もりに関連付けるために、その製品に基づく[商品項目](/api-reference/crm-line-items-v3/guide)を作成できます。商品項目は製品の個々のインスタンスであり、製品とは別のオブジェクトであるため、製品自体を更新することなく、必要に応じて取引や見積もりで商品やサービスを調整できます。 例えば、いずれか1つの製品が販売される取引をまとめるときには、まず製品から商品項目を作成し、それを取引に関連付けます。商品項目の作成と関連付けは、2つの別々の呼び出しで行うことも、1つの呼び出しで行うこともできます。両方のオプションを以下に示します。 ### 注： 商品項目は、1つの単一親オブジェクトに属します。オブジェクトを関連付ける場合、商品項目はラインアイテムはオブジェクトごとに個別にする必要があります。例えば取引と見積もりを作成する場合は、取引用に1つの商品項目セットを作成し、見積もり用に別の商品項目セットを作成する必要があります。これは、オブジェクト間でCRMデータを合理化し、商品項目を変更する必要があるときに予期しないデータ損失が発生しないようにするためです。例えば、見積もりを削除すると、見積もりの商品項目も削除されます。それらの商品項目が取引に関連付けられている場合、取引の商品項目も削除されます。 ### 商品項目を作成して関連付ける（複数の呼び出し） まず、IDが`1234567`である製品に基づいて商品項目を作成します。利用可能な商品項目プロパティー全てのリストを取得するには、[プロパティーAPI](/api-reference/crm-properties-v3/guide)に`GET`リクエストを送信します。商品項目のURLは`crm/v3/properties/line_items`となります。既存の製品から商品項目を作成しているため、その製品から価格などのプロパティー値を継承します。 ```json theme={null} { "properties": { "quantity": 1, "hs_object_id": "1234567", //the object ID of the product "name": "New line item (product-based)" } } ``` レスポンスで返される商品項目IDを使用すると、[関連付けAPI](/api-reference/crm-associations-v4/guide)を使ってそれを取引に関連付けることができます。この例では、返された商品項目IDが`7791176460`であると仮定します。 商品項目を既存の取引（ID：`14795354663`）に関連付けるには、`PUT`リクエストを`/crm/v4/objects/line_items/7791176460/associations/default/deals/14795354663`に送信します。このリクエストでは、デフォルトの関連付けタイプを使用します。 `200`レスポンスで、以下のような情報が返されます。 ```json theme={null} { "status": "COMPLETE", "results": [ { "from": { "id": "14795354663" }, "to": { "id": "7791176460" }, "associationSpec": { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 19 } }, { "from": { "id": "7791176460" }, "to": { "id": "14795354663" }, "associationSpec": { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 20 } } ], "startedAt": "2023-12-21T20:06:52.083Z", "completedAt": "2023-12-21T20:06:52.192Z" } ``` HubSpotでは、取引レコードの商品項目カードに「商品項目」が表示されます。 取引レコードに商品項目を関連付け ### 商品項目を作成して関連付ける（単一の呼び出し） 単一の呼び出しを使用して既存の製品から商品項目を作成し、取引に関連付けるには、商品項目の作成リクエストに`associations`配列を含めます。 商品項目を作成するには、`POST`リクエストを`crm/v3/objects/line_item`に送信します。リクエスト本文は以下のようになります。商品項目と取引の関連付けの`associationTypeId`は`20`であることに注意してください。詳しくは、[さまざまなタイプのCRMレコード間の関連付けタイプ](/api-reference/crm-associations-v4/guide#association-type-id-values)をご確認ください。 ```json theme={null} { "properties": { "quantity": 1, "hs_object_id": "1234567", //the object ID of the product "name": "New line item (product-based)" }, "associations": [ { "to": { "id": "14795354663" }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 20 } ] } ] } ``` `200`レスポンスで、新しい商品項目の詳細が返されます。HubSpotでは、取引レコードの商品項目カードに「商品項目」が表示されます。 取引レコードに商品項目を関連付け