HubSpotの製品は、販売する品物やサービスを表します。製品エンドポイントを使用することにより、製品データを管理したり同期したりできます。
POST
リクエストをcrm/v3/objects/products
に送信します。リクエスト本文に、作成時に設定する製品プロパティーを含むproperties
オブジェクトを含めます。後から同じエンドポイントにPATCH
リクエストを送信することで、製品のプロパティーを更新できます。
利用可能な全ての製品プロパティーを表示するには、プロパティーAPIにGET
リクエストを送信します。製品プロパティーを取得する場合のリクエストURLは/crm/v3/properties/products
になります。
hs_recurring_billing_period
の値はP#M
という形式(# は月数)であることに注意してください。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では、取引レコードの商品項目カードに「商品項目」が表示されます。