> ## 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 |  関連付けv4

export const postmanIcon = <svg xmlns="http://www.w3.org/2000/svg" width={25} height={25} preserveAspectRatio="xMidYMid" viewBox="0 0 256 256">
    <path fill="#FF6C37" d="M254.953 144.253c8.959-70.131-40.569-134.248-110.572-143.206C74.378-7.912 10.005 41.616 1.047 111.619c-8.959 70.003 40.569 134.248 110.572 143.334 70.131 8.959 134.248-40.569 143.334-110.7Z" />
    <path fill="#FFF" d="m174.2 82.184-54.007 54.007-15.229-15.23c53.11-53.11 58.358-48.503 69.236-38.777Z" />
    <path fill="#FF6C37" d="M120.193 137.47c-.384 0-.64-.128-.895-.384l-15.358-15.229a1.237 1.237 0 0 1 0-1.792c54.007-54.006 59.638-48.887 71.028-38.649.255.256.383.512.383.896s-.128.64-.383.896l-54.007 53.878c-.128.256-.512.384-.768.384Zm-13.437-16.509 13.437 13.438 52.087-52.087c-9.47-8.446-15.87-11.006-65.524 38.65Z" />
    <path fill="#FFF" d="m135.679 151.676-14.718-14.718 54.007-54.006c14.46 14.59-7.167 38.265-39.29 68.724Z" />
    <path fill="#FF6C37" d="M135.679 152.956c-.384 0-.64-.128-.896-.384l-14.718-14.718c-.256-.256-.256-.512-.256-.896s.128-.64.384-.895L174.2 82.056a1.237 1.237 0 0 1 1.791 0 15.58 15.58 0 0 1 4.991 11.902c-.256 14.206-16.38 32.25-44.28 58.614-.383.256-.767.384-1.023.384Zm-12.926-15.998c8.19 8.319 11.646 11.646 12.926 12.926 21.5-20.476 42.36-41.464 42.488-55.926.128-3.327-1.152-6.655-3.327-9.214l-52.087 52.214Z" />
    <path fill="#FFF" d="m105.22 121.345 10.878 10.878c.256.256.256.512 0 .768-.128.128-.128.128-.256.128l-22.524 4.863c-1.152.128-2.175-.64-2.431-1.791-.128-.64.128-1.28.512-1.664l13.053-13.054c.256-.256.64-.384.768-.128Z" />
    <path fill="#FF6C37" d="M92.934 139.262c-1.92 0-3.327-1.536-3.327-3.455 0-.896.384-1.792 1.024-2.432l13.053-13.054c.768-.64 1.792-.64 2.56 0l10.878 10.878c.768.64.768 1.792 0 2.56-.256.256-.512.384-.896.512l-22.524 4.863c-.256 0-.512.128-.768.128Zm11.902-16.51-12.542 12.543c-.256.256-.383.64-.128 1.024.128.383.512.511.896.383l21.116-4.607-9.342-9.342Z" />
    <path fill="#FFF" d="M202.739 52.238c-8.191-7.935-21.373-7.679-29.307.64-7.935 8.318-7.679 21.372.64 29.306A20.678 20.678 0 0 0 199.155 85l-14.59-14.59 18.174-18.172Z" />
    <path fill="#FF6C37" d="M188.405 89.223c-12.158 0-22.012-9.854-22.012-22.012 0-12.158 9.854-22.012 22.012-22.012 5.631 0 11.134 2.176 15.23 6.143.255.256.383.512.383.896s-.128.64-.384.895L186.357 70.41l13.566 13.566c.512.512.512 1.28 0 1.792l-.256.256c-3.327 2.047-7.295 3.199-11.262 3.199Zm0-41.337c-10.75 0-19.452 8.703-19.324 19.453 0 10.75 8.702 19.452 19.452 19.324 2.944 0 5.887-.64 8.575-2.047l-13.438-13.31c-.256-.256-.384-.512-.384-.896s.128-.64.384-.895l17.149-17.15c-3.456-2.943-7.807-4.479-12.414-4.479Z" />
    <path fill="#FFF" d="m203.122 52.622-.255-.256-18.301 18.044 14.461 14.462c1.408-.896 2.816-1.92 3.967-3.072a20.51 20.51 0 0 0 .128-29.178Z" />
    <path fill="#FF6C37" d="M199.155 86.28c-.384 0-.64-.128-.896-.384l-14.589-14.59c-.256-.256-.384-.512-.384-.896s.128-.64.384-.895l18.173-18.173a1.237 1.237 0 0 1 1.791 0l.384.256c8.575 8.574 8.575 22.396.128 31.098-1.28 1.28-2.687 2.432-4.223 3.328-.384.128-.64.256-.768.256Zm-12.798-15.87 12.926 12.926c1.024-.64 2.048-1.536 2.816-2.304 7.294-7.294 7.678-19.196.64-26.875L186.357 70.41Z" />
    <path fill="#FFF" d="M176.375 84.488a7.879 7.879 0 0 0-11.134 0l-48.247 48.247 8.063 8.063 51.062-44.792c3.328-2.816 3.584-7.807.768-11.134-.256-.128-.384-.256-.512-.384Z" />
    <path fill="#FF6C37" d="M124.929 142.077c-.384 0-.64-.128-.896-.383l-8.063-8.063a1.237 1.237 0 0 1 0-1.792l48.247-48.247a9.115 9.115 0 0 1 12.926 0 9.115 9.115 0 0 1 0 12.926l-.384.384-51.063 44.792c-.128.255-.384.383-.767.383Zm-6.143-9.342 6.27 6.271 50.167-44.024c2.816-2.304 3.072-6.527.768-9.342-2.303-2.816-6.526-3.072-9.342-.768-.128.128-.256.256-.512.384l-47.351 47.48Z" />
    <path fill="#FFF" d="M80.009 187.637c-.512.256-.768.768-.64 1.28l2.175 9.214c.512 1.28-.256 2.816-1.663 3.2-1.024.384-2.176 0-2.816-.768l-14.077-13.95 45.943-45.943 15.87.256 10.75 10.75c-2.56 2.175-18.045 17.149-55.542 35.961Z" />
    <path fill="#FF6C37" d="M78.985 202.61c-1.024 0-2.048-.383-2.688-1.151l-13.95-13.95c-.255-.256-.383-.512-.383-.896 0-.383.128-.64.384-.895l45.944-45.944c.256-.256.64-.384.895-.384l15.87.256c.383 0 .64.128.895.384l10.75 10.75c.256.256.384.64.384 1.024s-.128.64-.512.896l-.895.767c-13.566 11.902-31.995 23.804-54.902 35.194l2.175 9.086c.384 1.664-.384 3.456-1.92 4.352-.767.384-1.407.512-2.047.512Zm-14.078-15.997 13.182 13.054c.384.64 1.152.896 1.792.512.64-.384.896-1.152.512-1.792l-2.176-9.214c-.256-1.152.256-2.176 1.28-2.688 22.652-11.39 40.952-23.163 54.39-34.81l-9.47-9.47-14.718-.256-44.792 44.664Z" />
    <path fill="#FFF" d="m52.11 197.62 11.006-11.007 16.38 16.381-26.107-1.791c-1.151-.128-1.92-1.152-1.791-2.304 0-.512.128-1.024.512-1.28Z" />
    <path fill="#FF6C37" d="m79.497 204.146-26.236-1.791c-1.92-.128-3.199-1.792-3.071-3.712.128-.768.384-1.535 1.024-2.047L62.22 185.59a1.237 1.237 0 0 1 1.792 0l16.38 16.38c.385.385.512.897.257 1.408-.256.512-.64.768-1.152.768Zm-16.381-15.74-10.11 10.11c-.384.255-.384.895 0 1.151.127.128.255.256.511.256l22.652 1.536-13.053-13.054ZM104.452 146.557c-.768 0-1.28-.64-1.28-1.28 0-.384.128-.64.384-.896l12.414-12.414a1.237 1.237 0 0 1 1.792 0l8.062 8.063c.384.384.512.768.384 1.28-.128.384-.512.767-1.023.895l-20.477 4.352h-.256Zm12.414-11.902-8.446 8.446 13.821-2.943-5.375-5.503Z" />
    <path fill="#FFF" d="m124.8 140.926-14.077 3.071c-1.024.256-2.048-.384-2.303-1.408-.128-.64 0-1.28.511-1.791l7.807-7.807 8.063 7.935Z" />
    <path fill="#FF6C37" d="M110.467 145.277a3.168 3.168 0 0 1-3.2-3.2c0-.895.385-1.663.897-2.303l7.806-7.807a1.237 1.237 0 0 1 1.792 0l8.062 8.063c.384.384.512.768.384 1.28-.128.384-.512.767-1.023.895l-14.078 3.072h-.64Zm6.399-10.622-6.91 6.91c-.257.257-.257.512-.129.768s.384.384.768.384l11.774-2.56-5.503-5.502ZM203.25 64.907c-.256-.767-1.151-1.151-1.92-.895-.767.255-1.151 1.151-.895 1.92 0 .127.128.255.128.383.768 1.536.512 3.455-.512 4.863-.512.64-.384 1.536.128 2.048.64.512 1.536.384 2.048-.256 1.92-2.432 2.303-5.503 1.023-8.063Z" />
  </svg>;

export const ScopesList = ({scopes = [], description = "この API には、次のいずれかのスコープが必要です。"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

<Card title="Run in Postman" href="https://app.getpostman.com/run-collection/26126890-ebc9dd6f-bbd4-412b-b688-3553b6507c49" icon={postmanIcon} horizontal={true} />

<DndSection>
  <DndModule numCols={10}>
    <div>
      <Accordion title="スコープ要件">
        <ScopesList
          scopes={[
  'crm.objects.appointments.read',
  'crm.objects.appointments.sensitive.read.v2',
  'crm.objects.appointments.sensitive.write.v2',
  'crm.objects.appointments.write',
  'crm.objects.carts.read',
  'crm.objects.carts.write',
  'crm.objects.commercepayments.read',
  'crm.objects.commercepayments.write',
  'crm.objects.companies.highly_sensitive.read.v2',
  'crm.objects.companies.highly_sensitive.write.v2',
  'crm.objects.companies.read',
  'crm.objects.companies.sensitive.read.v2',
  'crm.objects.companies.sensitive.write.v2',
  'crm.objects.companies.write',
  'crm.objects.contacts.highly_sensitive.read.v2',
  'crm.objects.contacts.highly_sensitive.write.v2',
  'crm.objects.contacts.read',
  'crm.objects.contacts.sensitive.read.v2',
  'crm.objects.contacts.sensitive.write.v2',
  'crm.objects.contacts.write',
  'crm.objects.courses.read',
  'crm.objects.courses.write',
  'crm.objects.custom.highly_sensitive.read.v2',
  'crm.objects.custom.highly_sensitive.write.v2',
  'crm.objects.custom.read',
  'crm.objects.custom.sensitive.read.v2',
  'crm.objects.custom.sensitive.write.v2',
  'crm.objects.custom.write',
  'crm.objects.deals.highly_sensitive.read.v2',
  'crm.objects.deals.highly_sensitive.write.v2',
  'crm.objects.deals.read',
  'crm.objects.deals.sensitive.read.v2',
  'crm.objects.deals.sensitive.write.v2',
  'crm.objects.deals.write',
  'crm.objects.goals.read',
  'crm.objects.goals.write',
  'crm.objects.invoices.read',
  'crm.objects.invoices.write',
  'crm.objects.leads.read',
  'crm.objects.leads.write',
  'crm.objects.line_items.read',
  'crm.objects.line_items.write',
  'crm.objects.listings.read',
  'crm.objects.listings.write',
  'crm.objects.orders.read',
  'crm.objects.orders.write',
  'crm.objects.partner-clients.read',
  'crm.objects.partner-clients.write',
  'crm.objects.partner-services.read',
  'crm.objects.partner-services.write',
  'crm.objects.products.read',
  'crm.objects.products.write',
  'crm.objects.quotes.read',
  'crm.objects.quotes.write',
  'crm.objects.services.read',
  'crm.objects.services.write',
  'crm.objects.subscriptions.read',
  'crm.objects.subscriptions.write',
  'crm.objects.users.read',
  'crm.objects.users.write',
  'e-commerce',
  'media_bridge.read',
  'oauth',
  'tickets',
  'tickets.highly_sensitive.v2',
  'tickets.sensitive.v2'
]}
        />
      </Accordion>

      # 関連付けv4

      <RelatedApiLink />
    </div>
  </DndModule>

  <DndModule numCols={2} />
</DndSection>

<Warning>
  以前のバージョンについては、[v3の関連付けAPI](/api-reference/crm-associations-v3/guide)のドキュメントを参照してください。
</Warning>

関連付けは、HubSpotのCRM上のさまざまなオブジェクトとアクティビティー間の関係を表します。異なるオブジェクトのレコード間（例：コンタクトから会社）でも、同じオブジェクト内（例：会社から会社）でも、レコードを関連付けることができます。関連付けエンドポイントを使用することで、レコード、アクティビティー、またはレコード間の関連付けを作成、取得、更新、削除できます。

関連付けスキーマエンドポイントを使用すると、アカウントでサポートされている関連付けタイプを表示したり、独自の関連付けタイプを作成したり、レコードの関係にラベルを割り当てたりできます。関連付けラベルは、コンタクト、会社、取引、チケット、カスタムオブジェクト間でサポートされており、リストやワークフローなどの[HubSpotツール全体で使用](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels#use-association-labels-in-hubspot-tools)できます。

オブジェクト、レコード、プロパティー、および関連付けAPIの詳細については、「[CRMについて](/guides/crm/understanding-the-crm)」のガイドをご確認ください。

<Info>
  \*\*注：\*\*v4関連付けAPI は、NodeJS HubSpot Clientのバージョン9.0.0以降でサポートされています。
</Info>

## HubSpotで定義されている関連付けタイプ

HubSpotには、あらかじめ定義された一連の関連付けタイプが備わっています（例：会社へのコンタクトのラベルなしの関連付け）。しかし、アカウント管理者は[独自の関連付けラベルを定義](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels)して、レコード関係の追加情報を提供できます（マネージャー、従業員など）。HubSpot定義の関連付けタイプは次の2つです。

* \*\*プライマリー：\*\*他のレコードが関連付けられるメインの会社。プライマリー関連付けは、[リストやワークフロー](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels#use-associations-in-hubspot-tools)などのHubSpotツールで使用できます。複数の会社が関連付けられたレコードの場合、このAPIでは、プライマリーと見なされる会社の変更がサポートされます。
* **ラベルなし：**コンタクト、会社、取引、チケット、またはカスタムオブジェクトのレコードが関連付けられたときに追加される関連付けタイプ。このタイプは関連付けが存在することを示し、レスポンスで**ラベル**の値が常に`null`と返されます。レコードにプライマリー関連付けまたはカスタム関連付けラベルがある場合、これらのタイプは、ラベルなし関連付けタイプの横に表示されます。

HubSpotで定義されている全ての関連付けタイプを[このセクション](#association-type-id-values)で参照できます。

## 単一のラベルとペアのラベル

レコード間の関係を表すために使用できる[関連付けラベル](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels)には、次の2種類があります。

* \*\*単一：\*\*関係における両方のレコードに適用される1つのラベル。例えば「友人」、「同僚」などです。
* **ペア：**1組のラベル。関連付けられたレコードのそれぞれの側の関係性を表すために異なる語が使用される場合です。例えば**「親」と「子」**、「雇用主\*\*」と「従業員\*\*」などです。ペアのラベルを作成するには、リクエストに`inverseLabel`フィールドを含めて、ペアの2番目のラベルを指定する必要があります。

## 関連付けタイプを作成する

カスタム関連付けタイプは、[HubSpot](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels)内で、または関連付けスキーマAPIエンドポイントを使用して作成できます。各オブジェクトペア間に最大で10個の関連付けタイプを作成できます（例：コンタクトと会社、コンタクトとコンタクト）。

APIを使用して関連付けタイプを作成するには、`POST`リクエストを`/crm/v4/associations/{fromObjectType}/{toObjectType}/labels`に送信し、リクエストに次の情報を含めます。

* **name**：関連付けタイプの内部名。この値にハイフンを含めたり、値の先頭を数字にしたりすることは<u>できません</u>。
* **label**：[HubSpotで表示される関連付けラベル](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels)の名前。
* **inverseLabel**（ペアラベルのみ）：ラベルのペアにおける2番目のラベルの名前。

例えば、リクエストは次のようになります。

<DndSection>
  ```json theme={null}
  ///Example request body - Single label
  {
    "label": "Partner",
    "name": "partner"
  }
  ```

  ```json theme={null}
  ///Example request body - Paired labels
  {
    "label": "Manager",
    "inverseLabel": "Employee",
    "name": "manager_employee"
  }
  ```
</DndSection>

## 関連付けタイプを取得する

特定のオブジェクト間の関連付けタイプを表示するには、`GET`リクエストを`/crm/v4/associations/{fromObjectType}/{toObjectType}/labels`に送信します。

各項目に以下が含まれる配列が返されます。

* \*\*category：\*\*関連付けタイプがHubSpotとユーザーのどちらによって作成されたか（`HUBSPOT_DEFINED`または`USER_DEFINED`）を示します。
* \*\*typeId：\*\*その関連付けタイプの数値ID。これを使用して、[レコードを関連付けるときにラベルを設定](#associate-with-label)します。HubSpotで定義されている全ての`typeId`値については、[このリスト](#association-type-id-values)を参照してください。
* \*\*label：\*\*英数字のラベル。「ラベルなし」関連付けタイプの場合、これは`null`になります。

また、これらの値はHubSpotの[関連付け設定](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels#association-label-api-details)にもあります。

## レコードを関連付ける

### ラベルなしでレコードを関連付ける

2つのレコード間に既定のラベルなし関連付けを作成したり、レコードにラベルなし関連付けを一括で設定したりできます。2つのレコード間に既定の関連付けを個別に設定するには、`PUT`リクエストを

`/crm/v4/objects/{fromObjectType}/{fromObjectId}/associations/default/{toObjectType}/{toObjectId}`に送信します。

リクエストURLには、次の情報を含めます。

* `fromObjectType`\*\*：\*\*関連付けるオブジェクトのID。ID値を見つけるには、この[オブジェクトタイプIDのリスト](/guides/crm/understanding-the-crm#object-type-id)を参照してください。コンタクト、会社、取引、チケット、メモには、オブジェクト名（`contact`、`company`など）を使用できます。
* `fromObjectId`\*\*：\*\*関連付けるレコードのID。
* `toObjectType`\*\*：\*\*レコードの関連付け先となるオブジェクトのID。ID値を見つけるには、この[オブジェクトタイプIDのリスト](/guides/crm/understanding-the-crm#object-type-id)を参照してください。コンタクト、会社、取引、チケット、メモには、オブジェクト名（`contact`、`company`など）を使用できます。
* `toObjectId`\*\*：\*\*関連付け先となるレコードのID。

例えば、IDが12345であるコンタクトレコードを、IDが`67891`である会社レコードに関連付ける場合、リクエストURLは`/crm/v4/objects/contact/12345/associations/default/company/67891`になります。

既定の関連付けを一括で設定するには、`POST`リクエストを`crm/v4/associations/{fromObjectType}/{toObjectType}/batch/associate/default`に送信します。リクエスト本文に、関連付けるレコードの`objectId`値を含めます。

<Warning>
  \*\*注：\*\*1つのレコードに含めることができる関連付けの数は、[オブジェクトとHubSpotの配信登録](https://legal.hubspot.com/hubspot-product-and-services-catalog#TechnicalLimits:~:text=CRM%20Record%20Association%20Limits)によって異なります。
</Warning>

### ラベル付きでレコードを関連付ける

2つのレコードを関連付けて、その関連付けを記述するラベルを設定するには、`PUT`リクエストを`/crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}/{toObjectId}`に送信します。リクエスト本文に、作成する関連付けのタイプを示す`associationCategory`と`associationTypeId`を含めます。

ラベルのない関連付けを作成する場合は、[上記のセクション](#associate-records-without-a-label)で概説した、`associationCategory`や`associationTypeId`を必要としない既定のエンドポイントを使用できます。ラベルを使った関連付けを作成する場合は、この[既定のタイプIDのリスト](#association-type-id-values)を参照できます。または、これらのオブジェクト間のカスタム関連付けタイプを取得する必要があります。

<Info>
  \*\*注：\*\*クロスオブジェクトおよびペアになったラベルの関係の場合は、正しい方向を示す`typeId`を必ず使用してください（例：コンタクトから会社、会社からコンタクト、従業員からマネージャー、マネージャーから従業員）。
</Info>

例えば、カスタムラベルを使用してコンタクトを取引に関連付けるには、次のようにします。

1.`GET`リクエストを`/crm/v4/associations/contact/deal/labels`に送信します。

2.応答の中で、ラベルの`typeId`値と`category`値を確認します。IDは数値で（例えば`36`）、カスタムラベルの場合、カテゴリーは常に`USER_DEFINED`です。

3.次のリクエスト本文を使用して、`PUT`リクエストを`/crm/v4/objects/contact/{objectId}/associations/deal/{toObjectId}`に送信します。

```json theme={null}
/// Example request body
[
  {
    "associationCategory": "USER_DEFINED",
    "associationTypeId": 36
  }
]
```

## 関連付けの制限を設定および管理する

オブジェクト間で関連付けられるレコードの数や、ラベルを使って関連付けを記述できる頻度に対して、[制限](https://knowledge.hubspot.com/object-settings/set-limits-for-record-associations)を設定することができます。また、[技術的な制限やご利用のHubSpotの配信登録に応じた制限](https://legal.hubspot.com/hubspot-product-and-services-catalog)もあります。

### 関連付けの制限を作成または更新する

オブジェクト間の関連付けの制限を新規作成したり、既存の制限を更新したりできます。

* 制限を作成するには、`POST`リクエストを`crm/v4/associations/definitions/configurations/{fromObjectType}/{toObjectType}/batch/create`に送信します。
* 既存の制限を更新するには、`POST`リクエストを`crm/v4/associations/definitions/configurations/{fromObjectType}/{toObjectType}/batch/update`に送信します。

リクエスト本文に、以下のものを使用した`inputs`を含めます。

| パラメーター           | 説明                                                                                                                                |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `category`       | 制限を設定する対象の関連付けのカテゴリー。`HUBSPOT_DEFINED`または`USER_DEFINED`のいずれかです。                                                                   |
| `typeId`         | 制限を設定する対象となる関連付けタイプの数値ID。既定の`typeId`値の[リスト](#association-type-id-values)を参照するか、カスタムラベルの[値を取得](#retrieve-association-types)してください。 |
| `maxToObjectIds` | 関連付けタイプで許容される関連付けの最大数。                                                                                                            |

例えば、1つの取引に関連付けられるコンタクトは最大で5つ、取引の「Point of contact」というラベルを付けられるコンタクトは1つだけ、という制限を設定する場合には、次のようなリクエストになります。

```json theme={null}
//Example request POST crm/v4/associations/definitions/configurations/deal/contact/batch/create
{
  "inputs": [
    {
      "category": "HUBSPOT_DEFINED",
      "typeId": 3,
      "maxToObjectIds": 5
    },
    {
      "category": "USER_DEFINED",
      "typeId": 35,
      "maxToObjectIds": 1
    }
  ]
}
```

### 関連付け制限を取得する

* 定義されている全ての関連付け制限を読み取るには、`GET`リクエストを`/crm/v4/associations/definitions/configurations/all`に送信します。これにより、全てのオブジェクトで定義されているカスタム関連付け制限が返されます。
* 特定の2つのオブジェクト間の関連付け制限を読み取るには、`GET`リクエストを`/crm/v4/associations/definitions/configurations/{fromObjectType}/{toObjectType}`に送信します。

どちらのリクエストの場合も、応答では関連付けの`category`、`typeId`、`maxToObjectIds`、`label`の値が返されます。例えば、取引とコンタクトの間の制限を取得する場合、応答は次のようになります。

```json theme={null}
//Example response GET crm/v4/associations/definitions/configurations/deal/contact
{
  "results": [
    {
      "category": "HUBSPOT_DEFINED",
      "typeId": 3,
      "userEnforcedMaxToObjectIds": 5,
      "label": null
    }
  ]
}
```

### 関連付けの制限を削除する

特定の関連付け制限を削除するには、`POST`リクエストを`/crm/v4/associations/definitions/configurations/{fromObjectType}/{toObjectType}/batch/purge`に送信します。リクエスト本文に、制限を削除する対象の関連付けタイプの`category`値と`typeId`値を含めます。

例えば、取引とコンタクトの間の「Point of contact」制限を削除するには、次のようなリクエストになります。

```json theme={null}
//Example request POST crm/v4/associations/definitions/configurations/deal/contact/batch/purge
{
  "inputs": [
    {
      "category": "USER_DEFINED",
      "typeId": 35
    }
  ]
}
```

これが成功すると204レスポンスが返され、含まれる制限はシステムの既定値に戻ります（つまり多くのコンタクトに*Point ofcontact*というラベルを使用できます）。

## 高い関連付け使用率に関するレポート

１つのレコードに可能な関連付けの数には、技術的な[制限](https://legal.hubspot.com/hubspot-product-and-services-catalog)があります。関連付けAPIを使用すると、関連付けの上限に近づいている、または上限に達したレコードのレポートを取得できます。

レポートを取得するには、`POST`リクエストを`crm/v4/associations/usage/high-usage-report/{userID}`に送信します。ファイルには、関連付け制限の80%以上を使用しているレコードが含まれます。例えば、1つの会社を最大50,000件のコンタクトに関連付けることができる場合、既に40,000件以上のコンタクトが関連付けられている会社がファイルに含まれます。ファイルは、リクエストURLにIDが含まれていたユーザーのEメールに送信されます。[ユーザーAPI](/api-reference/settings-user-provisioning-v3/guide)を使用してユーザーIDを取得する方法をご確認ください。

## 関連付けタイプID値

HubSpotで定義された、関連付けのタイプを指定する`associationTypeId`値を以下の表に示します。関連付けタイプは、含まれるオブジェクトと関連付けの方向によって異なります（例えば「コンタクトから会社」は「会社からコンタクト」とは異なります）。カスタムオブジェクトまたはカスタム関連付けラベルを作成する場合、該当する関連付けタイプには固有の`typeId`値があり、これらの値を[取得する](#retrieve-association-type)か、[HubSpotの関連付け設定](https://knowledge.hubspot.com/object-settings/create-and-use-association-labels#association-label-api-details)でこれらの値を見つける必要があります。

<Warning>
  **注**：既定の会社関連付けタイプには、ラベルなし関連付けタイプとプライマリー関連付けタイプが含まれています。レコードに複数の会社が関連付けられている場合、1つだけをプライマリー会社にすることができます。その他の関連付けには、ラベルがないか、またはカスタム関連付けラベルを付けることができます。
</Warning>

<DndSection>
  <DndModule numCols={6}>
    #### コンタクトからオブジェクトへ

    | タイプID | 関連付けタイプ                                            |
    | ----- | -------------------------------------------------- |
    | `449` | コンタクトからコンタクトへ                                      |
    | `279` | コンタクトから会社へ                                         |
    | `1`   | コンタクトから会社へ（プライマリー）                                 |
    | `4`   | コンタクトから取引へ                                         |
    | `15`  | コンタクトからチケットへ                                       |
    | `193` | コンタクトからコールへ                                        |
    | `197` | コンタクトからEメールへ                                       |
    | `199` | コンタクトからミーティングへ                                     |
    | `201` | コンタクトからメモへ                                         |
    | `203` | コンタクトからタスクへ                                        |
    | `82`  | コンタクトからコミュニケーション機能へ（SMS、WhatsApp、またはLinkedInメッセージ） |
    | `454` | コンタクトから郵便へ                                         |
    | `587` | コンタクトからカートへ                                        |
    | `508` | コンタクトから注文へ                                         |
    | `178` | コンタクトから請求書へ                                        |
    | `388` | コンタクトから支払いへ                                        |
    | `296` | コンタクトから配信登録へ                                       |
  </DndModule>

  <DndModule numCols={6}>
    #### 会社からオブジェクトへ

    | タイプID | 関連付けタイプ                                         |
    | ----- | ----------------------------------------------- |
    | `450` | 会社から会社へ                                         |
    | `14`  | 子会社から親会社へ                                       |
    | `13`  | 親会社から子会社へ                                       |
    | `280` | 会社からコンタクトへ                                      |
    | `2`   | 会社からコンタクトへ（プライマリー）                              |
    | `342` | 会社から取引へ                                         |
    | `6`   | 会社から取引へ（プライマリー）                                 |
    | `340` | 会社からチケットへ                                       |
    | `25`  | 会社からチケットへ（プライマリー）                               |
    | `181` | 会社からコールへ                                        |
    | `185` | 会社からEメールへ                                       |
    | `187` | 会社からミーティングへ                                     |
    | `189` | 会社からメモへ                                         |
    | `191` | 会社からタスクへ                                        |
    | `88`  | 会社からコミュニケーション機能へ（SMS、WhatsApp、またはLinkedInメッセージ） |
    | `460` | 会社から郵便へ                                         |
    | `180` | 会社から請求書へ                                        |
    | `510` | 会社から注文へ                                         |
    | `390` | 会社から支払いへ                                        |
    | `298` | 会社から配信登録へ                                       |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### 取引からオブジェクトへ

    | タイプID | 関連付けタイプ                                         |
    | ----- | ----------------------------------------------- |
    | `451` | 取引から取引へ                                         |
    | `3`   | 取引からコンタクトへ                                      |
    | `341` | 取引から会社へ                                         |
    | `5`   | 取引から会社へ（プライマリー）                                 |
    | `27`  | 取引からチケットへ                                       |
    | `205` | 取引からコールへ                                        |
    | `209` | 取引からEメールへ                                       |
    | `211` | 取引からミーティングへ                                     |
    | `213` | 取引からメモへ                                         |
    | `215` | 取引からタスクへ                                        |
    | `86`  | 取引からコミュニケーション機能へ（SMS、WhatsApp、またはLinkedInメッセージ） |
    | `458` | 取引から郵便へ                                         |
    | `313` | 取引から取引分割へ                                       |
    | `19`  | 取引から商品項目へ                                       |
    | `176` | 取引から請求書へ                                        |
    | `511` | 取引から注文へ                                         |
    | `392` | 取引から支払へ                                         |
    | `630` | 取引から製品へ                                         |
    | `63`  | 取引から見積もりへ                                       |
    | `300` | 取引から配信登録へ                                       |
  </DndModule>

  <DndModule numCols={6}>
    #### チケットからオブジェクトへ

    | タイプID | 関連付けタイプ                                           |
    | ----- | ------------------------------------------------- |
    | `452` | チケットからチケットへ                                       |
    | `16`  | チケットからコンタクトへ                                      |
    | `339` | チケットから会社へ                                         |
    | `26`  | チケットから会社へ（プライマリー）                                 |
    | `28`  | チケットから取引へ                                         |
    | `219` | チケットからコールへ                                        |
    | `223` | チケットからEメールへ                                       |
    | `225` | チケットからミーティングへ                                     |
    | `227` | チケットからメモへ                                         |
    | `229` | チケットからタスクへ                                        |
    | `84`  | チケットからコミュニケーション機能へ（SMS、WhatsApp、またはLinkedInメッセージ） |
    | `456` | チケットから郵便へ                                         |
    | `32`  | チケットからスレッドへ                                       |
    | `278` | チケットからコミュニケーションへ                                  |
    | `526` | チケットから注文へ                                         |

    ### リードからオブジェクトへ

    | タイプID | 関連付けタイプ           |
    | ----- | ----------------- |
    | `578` | リードからプライマリーコンタクトへ |
    | `596` | リードからコールへ         |
    | `598` | リードからEメールへ        |
    | `600` | リードからミーティングへ      |
    | `602` | リードからコミュニケーション機能へ |
    | `608` | リードからコンタクトへ       |
    | `610` | リードから会社へ          |
    | `646` | リードからタスクへ         |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### コールからオブジェクトへ

    | タイプID | 関連付けタイプ     |
    | ----- | ----------- |
    | `194` | コールからコンタクトへ |
    | `182` | コールから会社へ    |
    | `206` | コールから取引へ    |
    | `220` | コールからチケットへ  |
  </DndModule>

  <DndModule numCols={6}>
    #### Eメールからオブジェクトへ

    | タイプID | 関連付けタイプ      |
    | ----- | ------------ |
    | `198` | Eメールからコンタクトへ |
    | `186` | Eメールから会社へ    |
    | `210` | Eメールから取引へ    |
    | `224` | Eメールからチケットへ  |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### ミーティングからオブジェクトへ

    | タイプID | 関連付けタイプ        |
    | ----- | -------------- |
    | `200` | ミーティングからコンタクトへ |
    | `188` | ミーティングから会社へ    |
    | `212` | ミーティングから取引へ    |
    | `226` | ミーティングからチケットへ  |
  </DndModule>

  <DndModule numCols={6}>
    #### メモからオブジェクトへ

    | タイプID | 関連付けタイプ    |
    | ----- | ---------- |
    | `202` | メモからコンタクトへ |
    | `190` | メモから会社へ    |
    | `214` | メモから取引へ    |
    | `228` | メモからチケットへ  |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### 郵便からオブジェクトへ

    | タイプID | 関連付けタイプ    |
    | ----- | ---------- |
    | `453` | 郵便からコンタクトへ |
    | `459` | 郵便から会社へ    |
    | `457` | 郵便から取引へ    |
    | `455` | 郵便からチケットへ  |
  </DndModule>

  <DndModule numCols={6}>
    #### 見積もりからオブジェクトへ

    | タイプID | 関連付けタイプ           |
    | ----- | ----------------- |
    | `69`  | 見積もりからコンタクトへ      |
    | `71`  | 見積もりから会社へ         |
    | `64`  | 見積もりから取引へ         |
    | `67`  | 見積もりから商品項目へ       |
    | `286` | 見積もりから見積もりテンプレートへ |
    | `362` | 見積もりから割引へ         |
    | `364` | 見積もりから料金へ         |
    | `366` | 見積もりから税金へ         |
    | `702` | コンタクト署名者（電子署名の場合） |
    | `733` | 見積もりからカートへ        |
    | `408` | 見積もりから請求書へ        |
    | `731` | 見積もりから注文へ         |
    | `398` | 見積もりから支払いへ        |
    | `304` | 見積もりから配信登録へ       |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    #### タスクからオブジェクトへ

    | タイプID | 関連付けタイプ     |
    | ----- | ----------- |
    | `204` | タスクからコンタクトへ |
    | `192` | タスクから会社へ    |
    | `216` | タスクから取引へ    |
    | `230` | タスクからチケットへ  |
  </DndModule>

  <DndModule numCols={6}>
    #### コミュニケーション機能（SMS、WhatsApp、またはLinkedInメッセージ）からオブジェクトへ

    | タイプID | 関連付けタイプ                                            |
    | ----- | -------------------------------------------------- |
    | `81`  | コミュニケーション機能（SMS、WhatsApp、またはLinkedInメッセージ）からコンタクトへ |
    | `87`  | コミュニケーション機能（SMS、WhatsApp、またはLinkedInメッセージ）から会社へ    |
    | `85`  | コミュニケーション機能（SMS、WhatsApp、またはLinkedInメッセージ）から取引へ    |
    | `83`  | コミュニケーション機能（SMS、WhatsApp、またはLinkedInメッセージ）からチケットへ  |
  </DndModule>
</DndSection>

<DndSection>
  <DndModule numCols={6}>
    ### 注文からオブジェクトへ

    | タイプID | 関連付けタイプ    |
    | ----- | ---------- |
    | `593` | 注文からカートへ   |
    | `507` | 注文からコンタクトへ |
    | `509` | 注文から会社へ    |
    | `512` | 注文から取引へ    |
    | `519` | 注文から割引へ    |
    | `521` | 注文から割引コードへ |
    | `518` | 注文から請求書へ   |
    | `513` | 注文から商品項目へ  |
    | `523` | 注文から支払へ    |
    | `730` | 注文から見積もりへ  |
    | `516` | 注文から配信登録へ  |
    | `726` | 注文からタスクへ   |
    | `525` | 注文からチケットへ  |
  </DndModule>

  <DndModule numCols={6}>
    ### カートからオブジェクトへ

    | タイプID | 関連付けタイプ     |
    | ----- | ----------- |
    | `586` | カートからコンタクトへ |
    | `588` | カートから割引へ    |
    | `590` | カートから商品項目へ  |
    | `592` | カートから注文へ    |
    | `732` | カートから見積もりへ  |
    | `728` | カートからタスクへ   |
    | `594` | カートからチケットへ  |
  </DndModule>
</DndSection>

## v1関連付け（レガシー）

v1関連付けAPIを使用している場合、レコードを関連付けるときに使用するIDについて、下記の表を参照してください。

| 関連付けタイプ          | ID  |
| ---------------- | --- |
| コンタクトから会社へ       | 1   |
| 会社からコンタクトへ（既定）   | 2   |
| 会社からコンタクトへ（全ラベル） | 280 |
| 取引からコンタクトへ       | 3   |
| コンタクトから取引へ       | 4   |
| 取引から会社へ          | 5   |
| 会社から取引へ          | 6   |
| 会社からエンゲージメントへ    | 7   |
| エンゲージメントから会社へ    | 8   |
| コンタクトからエンゲージメントへ | 9   |
| エンゲージメントからコンタクトへ | 10  |
| 取引からエンゲージメントへ    | 11  |
| エンゲージメントから取引へ    | 12  |
| 親会社から子会社へ        | 13  |
| 子会社から親会社へ        | 14  |
| コンタクトからチケットへ     | 15  |
| チケットからコンタクトへ     | 16  |
| チケットからエンゲージメントへ  | 17  |
| エンゲージメントからチケットへ  | 18  |
| 取引から商品項目へ        | 19  |
| 商品項目から取引へ        | 20  |
| 会社からチケットへ        | 25  |
| チケットから会社へ        | 26  |
| 取引からチケットへ        | 27  |
| チケットから取引へ        | 28  |