> ## 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. # エンゲージメント | メモ 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}

)}

; }; CRMレコードにメモを記録して、レコードのタイムラインに情報を追加したり、添付ファイルをレコードに関連付けたりすることができます。例えば、コンタクトとのオフラインコミュニケーションを追跡する必要がある場合は、そのコミュニケーションに関連する詳細情報やドキュメントをコンタクトレコードにメモとして追加できます。その後、アカウント内の他のユーザーがそのメモを表示して参照できるようになります。メモは、[HubSpot](https://knowledge.hubspot.com/ja/records/manually-log-activities-on-records)内で、またはメモAPIを通じて管理できます。この記事では、APIを使用したノートの基本的な管理方法を説明します。利用可能な全てのエンドポイントは、[リファレンスドキュメント](/api-reference/crm-notes-v3/guide)でご確認いただけます。 ## メモを作成するメモを作成するには、`POST`リクエストを`/crm/v3/objects/notes`に送信します。リクエスト本文で、**properties**オブジェクト内にメモの詳細を追加します。また、**associations**オブジェクトを追加して、新しいメモを既存のレコード（コンタクト、会社など）に関連付けることもできます。 ### プロパティー Propertiesオブジェクトには、次のフィールドを含めることができます。 | フィールド | 説明 | | ------------------- | ------------------------------------------------------------------------------------------------------------------- | | `hs_timestamp` | 必須。このフィールドは、メモの作成時刻を記録し、レコードタイムラインでのそのメモの表示位置を決定します。ミリ秒単位またはUTC形式のUnixタイムスタンプを使用できます。 | | `hs_note_body` | メモのテキストコンテンツ。65,536文字までに制限されています。 | | `hubspot_owner_id` | メモに関連付けられている[担当者のID](/api-reference/crm-crm-owners-v3/guide)。このフィールドにより、HubSpotのレコードタイムラインにメモ作成者として表示されるユーザーが決まります。 | | `hs_attachment_ids` | メモの添付ファイルのID。複数の添付ファイルIDはそれぞれセミコロンで区切られます。 | ### 関連付けメモを作成して既存のレコードと関連付けるには、リクエストにassociationsオブジェクトを含めます。例えば、メモを作成して会社と取引に関連付ける場合、リクエスト本文は次のようになります。 ```json theme={null} // Example POST request to https://api.hubspot.com/crm/v3/objects/notes { "properties": { "hs_timestamp": "2021-11-12T15:48:22Z", "hs_note_body": "Spoke with decision maker Carla. Attached the proposal and draft of contract.", "hubspot_owner_id": "14240720", "hs_attachment_ids": "24332474034;24332474044" }, "associations": [ { "to": { "id": 301 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 190 } ] }, { "to": { "id": 401 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 214 } ] } ] } ``` Associationsオブジェクトには、次のものを含める必要があります。 | フィールド | 説明 | | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `to` | メモに関連付けるレコード。一意の`id`値で指定します。 | | `types` | メモとレコードの間の関連付けのタイプ。`associationCategory`および`associationTypeId`を含めます。デフォルトの関連付けタイプIDは[こちらのページ](/api-reference/crm-associations-v4/guide#association-type-id-values)に記載されています。または、[関連付けAPI](/api-reference/crm-associations-v4/guide#retrieve-association-types)を使用して、カスタムの関連付けタイプ（ラベル）の値を取得することもできます。 | メモを一括で作成する方法については、[リファレンスドキュメント](/api-reference/crm-notes-v3/guide#post-%2Fcrm%2Fv3%2Fobjects%2Fnotes%2Fbatch%2Fcreate)をご参照ください。 ## メモを取得するメモを個別に、または一括で取得することができます。個々のメモを取得するには、`GET`リクエストを`/crm/v3/objects/notes/{noteId}`に送信します。全てのメモのリストを取得するには、`GET`リクエストを`/crm/v3/objects/notes`に送信します。どちらのエンドポイントに対しても、リクエストのURLに次のクエリーパラメーターを含めることができます。 | パラメーター | 説明 | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | `properties` | レスポンスで返される、プロパティーのカンマ区切りのリスト。リクエスト対象のメモで、指定したプロパティーに値が設定されていない場合、そのプロパティーはレスポンスに含まれません。 | | `associations` | 関連付けられているIDが取得されるオブジェクトタイプのカンマ区切りのリスト。存在しない関連付けを指定した場合、その関連付けはレスポンスで返されません。詳しくは[関連付けAPI](/api-reference/crm-associations-v4/guide)をご参照ください。 | 例えば、特定のテキストコンテンツおよび関連付けられているコンタクトIDを含むメモを取得する場合、リクエストURLは次のようになります。 `https://api.hubapi.com/crm/v3/objects/notes?limit=10&properties=hs_note_body&associations=contact&archived=false` 内部IDまたは一意のプロパティー値によってメモを一括で取得する方法については、[リファレンスドキュメント](/api-reference/crm-notes-v3/guide#post-%2Fcrm%2Fv3%2Fobjects%2Fnotes%2Fbatch%2Fread)をご参照ください。 ## メモを更新するメモを個別に、または一括で更新することができます。メモIDを指定して個別のメモを更新するには、`PATCH`リクエストを`/crm/v3/objects/notes/{noteId}`に送信します。リクエスト本文には次のように更新するメモプロパティーを含めます。 ```json theme={null} // Example PATCH request to https://api.hubspot.com/crm/v3/objects/notes/{noteID} { "properties": { "hs_note_body": "Spoke with decision maker Carla.", "hs_attachment_ids": "24332474034;24332474044" } } ``` HubSpotでは、読み取り専用プロパティーおよび存在しないプロパティーの値が無視されます。プロパティー値をクリアするには、リクエストの本文でプロパティーの空の文字列を渡します。メモを一括で更新する方法については、[リファレンスドキュメント](/api-reference/crm-notes-v3/guide#post-%2Fcrm%2Fv3%2Fobjects%2Fnotes%2Fbatch%2Fupdate)をご参照ください。 ### 既存のメモをレコードに関連付けるメモをコンタクトなどの他のCRMレコードに関連付けるには、`PUT`リクエストを`/crm/v3/objects/notes/{noteId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}`に送信します。リクエストのURLには次のフィールドが含まれます。 | フィールド | 説明 | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | `noteId` | メモのID。 | | `toObjectType` | メモに関連付けるオブジェクトのタイプ（コンタクト、会社など）。 | | `toObjectId` | メモに関連付けるレコードのID。 | | `associationTypeId` | メモと他のオブジェクトとの関連付けタイプを示す一意の識別子。このIDは、数値またはスネークケース（例：`note_to_contact`）で表すことができます。該当する値は[関連付けAPI](/api-reference/crm-associations-v3/guide)を介して取得できます。 | 例えば、リクエストのURLは次のようになります。 `https://api.hubspot.com/crm/v3/objects/notes/17147287858/associations/contact/581751/202` ### 関連付けを削除するメモとレコードの間の関連付けを削除するには、上記と同じ以下のURLに対して`DELETE`リクエストを送信します。 `/crm/v3/objects/notes/{noteId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}` ## レコードでメモをピン留めするレコードで[メモをピン留め](https://knowledge.hubspot.com/ja/records/pin-an-activity-on-a-record)して、レコードのタイムラインの上部に常に表示されるようにすることができます。ピン留めする前に、メモが既にレコードに関連付けられている必要があり、1つのレコードにつき1つのアクティビティーのみをピン留めできます。メモをピン留めするには、オブジェクトAPIを介してレコードを作成または更新するときに、`hs_pinned_engagement_id`フィールドにメモの`id`を含めます。詳しくは、[会社](/api-reference/crm-companies-v3/guide#pin-an-activity-on-a-company-record)、[コンタクト](/api-reference/crm-contacts-v3/guide#pin-an-activity-on-a-contact-record)、[取引](/api-reference/crm-deals-v3/guide#pin-an-activity-on-a-deal-record)、[チケット](/api-reference/crm-tickets-v3/guide#pin-an-activity-on-a-ticket-record)、および[カスタムオブジェクト](/api-reference/crm-custom-objects-v3/guide)のAPIの使用に関する説明をご参照ください。 ## メモを削除するメモを個別に、または一括で削除することができます。削除したメモは、HubSpot内のごみ箱に追加されます。そのため、後で[レコードタイムラインからメモを復元](https://knowledge.hubspot.com/ja/records/restore-deleted-activity-in-a-record)することも可能です。メモIDを指定して個別のメモを削除するには、`DELETE`リクエストを`/crm/v3/objects/notes/{noteId}`に送信します。メモの削除について詳しくは、[リファレンスドキュメント](/api-reference/crm-notes-v3/guide#delete-%2Fcrm%2Fv3%2Fobjects%2Fnotes%2F%7Bnoteid%7D)をご参照ください。