> ## 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.

# 配信設定v3

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>;
};

<PostmanCard collectionId="26126890-66058718-01c5-4cba-894c-77500dc03585" />

<Accordion title="スコープの要件">
  <ScopesList
    scopes={[
  'communication_preferences.read',
  'communication_preferences.read_write',
  'communication_preferences.write'
]}
  />
</Accordion>

配信カテゴリーは、Eメールを通じてコンタクトと通信するための法的根拠を示すものです。コンタクトは[Eメール設定を管理](https://knowledge.hubspot.com/marketing-email/insert-subscription-links-into-marketing-emails)できるため、受信を希望するEメールにのみオプトインします。

<Warning>
  **注**:

  現時点では、配信設定APIは[WhatsApp](https://knowledge.hubspot.com/inbox/collect-consent-for-whatsapp-conversations)の配信登録情報の受信および更新をサポート<u>していません</u>。
</Warning>

## コンタクトの配信登録ステータスを取得する

コンタクト配信登録ステータスエンドポイントから、アカウント内のEメールアドレスに関する配信登録のステータスを取得できます。

外部の配信設定センターまたは連携機能を使用している状態で、アカウント内の特定のEメールアドレスの配信登録ステータスを確認する場合に、このエンドポイントが役立ちます。

***

## コンタクトを配信登録する

コンタクト配信登録エンドポイントでは、アカウント内の特定の配信カテゴリーにEメールアドレスを登録できますが、**オプトアウトしたコンタクトの再登録はできません**。

<Warning>
  **注**:

  配信設定APIの新しいバージョンであるv4では、以前にオプトアウトしたコンタクトの再登録がサポートされています。v4 APIの詳細については 、[こちら](/api-reference/communication-preferences-subscriptions-v4/guide)の記事をご覧ください。
</Warning>

**使用例**: 連携機能または外部フォームを通じて、特定の配信カテゴリーへのコンタクトのオプトインを行う場合に、このエンドポイントが役立ちます。

**注**：コンタクト配信登録エンドポイントは、貴社による配信登録を認めたコンタクトからのリクエストにのみ使用してください。コンタクトの配信登録の前には、[適用される法令および規制を十分に確認](https://knowledge.hubspot.com/marketing-email/set-up-email-subscription-types)してください。

***

## コンタクトを登録解除する

コンタクト配信解除エンドポイントでは、アカウント内のEメールアドレスを特定の配信カテゴリーから解除できます。

**使用例**: 連携機能または外部フォームを通じて、特定の配信カテゴリーからのコンタクトのオプトアウトを行う場合に、このエンドポイントが役立ちます。

***

## 配信カテゴリーを取得する

配信情報エンドポイントを使用すると、アカウント内の全ての配信カテゴリーを取得できます。

**使用例**: 外部の配信設定センター、連携機能、またはフォームを使用している状態で、（コンタクトに関する最新の配信登録ステータスを取得する際に）アカウント内に存在する配信カテゴリーを確認する場合に、このエンドポイントが役立ちます。

***