{scope}
リストをマーケティングイベントに関連付けると、HubSpotアカウントのマーケティングイベントの詳細ページに表示されます。
* HubSpotアカウントで、［CRM］>［コンタクト］に移動します\*\*。 \*\*\*\* \*\*
* 左上の［コンタクト］をクリックし、ドロップダウンメニューから［マーケティングイベント］を選択します\*\*。 \*\*\*\* \*\*
* マーケティングイベントの**名前**をクリックします。
* ［パフォーマンス］タブで、［リスト］をクリックしてセクションを展開し、**［関連付け］タブから追加したリスト**をクリックします。\_ \_\*\* \*\*
### マーケティングイベントIDを使用してリストの関連付けを作成する
マーケティングイベントと既存のリストの間に新しい関連付けを作成するには、`PUT`リクエストを`/marketing/v3/marketing-events/associations/{marketingEventId}/lists/{listId}`に送信します。
リクエストが正常に完了すると、`204 No content`レスポンスが返されます。
### 外部イベントIDとアカウントIDを使用してリストの関連付けを作成する
外部アカウントIDと外部イベントIDを使用して、マーケティングイベントと既存のリストの間に新しい関連付けを作成するには、`PUT`リクエストを`/marketing/v3/marketing-events/associations/{externalAccountId}/{externalEventId}/lists/{listId}`に送信します。
リクエストが正常に完了すると、`204 No content`レスポンスが返されます。
### マーケティングイベントIDを使用してマーケティングイベントに関連付けられたリストを取得する
マーケティングイベントに関連付けられている全てのリストを取得するには、`/marketing/v3/marketing-events/associations/{marketingEventId}/lists`に`GET`リクエストを送信します。
レスポンスは次のようになります。
```json theme={null}
{
"total": 1,
"results": [
{
"listId": "string",
"listVersion": 0,
"createdAt": "2024-05-10T08:58:35.769Z",
"updatedAt": "2024-05-10T08:58:35.769Z",
"filtersUpdatedAt": "2024-05-10T08:58:35.769Z",
"processingStatus": "string",
"createdById": "string",
"updatedById": "string",
"processingType": "string",
"objectTypeId": "string",
"name": "string",
"size": 0
}
]
}
```
### 外部イベントIDとアカウントIDを使用してイベントに関連付けられたリストを取得する
また、外部アカウントIDと外部イベントIDを使用してマーケティングイベントに関連付けられたリストを取得し、`GET`リクエストを`/marketing/v3/marketing-events/associations/{externalAccountId}/{externalEventId}/lists`に送信することもできます。
### マーケティングイベントIDを使用してリストの関連付けを削除する
マーケティングイベントIDを使用してマーケティングイベントのリスト関連付けを削除するには、`DELETE`リクエストを`/marketing/v3/marketing-events/associations/{marketingEventId}/lists/{listId}`に送信します。
リクエストが正常に完了すると、`204 No content`レスポンスが返されます。
### 外部イベントIDとアカウントIDを使用してリストの関連付けを削除する
外部アカウントIDと外部イベントIDを使用してマーケティングイベントのリストの関連付けを削除するには、`DELETE`リクエストを`/marketing/v3/marketing-events/associations/{externalAccountId}/{externalEventId}/lists/{listId}`に送信します。
リクエストが正常に完了すると、`204 No content`レスポンスが返されます。
## アプリ設定を構成する
マーケティングイベントがHubSpotと適切に同期するためには、いくつかの設定が必要です。
HubSpotに参加状態の変更（登録やキャンセルなど）を送信すると、HubSpotはまず、指定されたイベントIDに対応するマーケティングイベントが存在するかどうかを確認します。存在しない場合、HubSpotはアプリに設定されたエンドポイントを呼び出してマーケティングイベントの詳細を取得し、HubSpotでイベントを作成してから、参加状態の変更を公開します。
これは利便性を目的に提供されている機能ですが、HubSpotでマーケティングイベントを作成するこの機能には依存せず、[リファレンスドキュメント](/api-reference/marketing-marketing-events-v3/guide)に記載されているCRUDメソッドを使用して、マーケティングイベントを自分で作成することをお勧めします。
### ステップ1：アプリでAPIを作成する
マーケティングイベントをサポートするためにHubSpotでは、マーケティングイベントを使用する各アプリでAPIを定義し、特定のマーケティングイベントに関する情報を取得することを要件としています。
要件：
* 許容値：
* `externalAccountId`：外部アプリの顧客のaccountIdを指定するクエリーパラメーター。
* `appId`：イベントの詳細をリクエストしているHubSpotアプリケーションのIDを指定するクエリーパラメーター。これはアプリのIDになります。
* `externalEventId`：HubSpotが詳細な情報をリクエストしている外部アプリのイベントのIDを指定する、リクエストのURL内のパスパラメーター。
* 戻り値：
* マーケティングイベントの詳細を提供するJSONオブジェクト。以下の表で詳しく説明しているフィールドを含みます。
\| フィールド名 | 必須 | 型 | フィールドの説明 |
\| ------------------ | ----- | -------------------- | --------------------------------------------------------------------------------- | ---------------- |
\| `eventName` | true | 文字列 | マーケティングイベントの名前。 |
\| `eventOrganizer` | true | 文字列 | マーケティングイベントの主催者の名前。 |
\| `eventType` | false | 文字列 | このイベントのタイプを説明します。`WEBINAR`、`CONFERENCE`、`WORKSHOP` | など。 |
\| `startDateTime` | false | 文字列（$date-time） | マーケティングイベントの開始日時。 | | `endDateTime` | false | 文字列（$date-time） | マーケティングイベントの終了日時。 |
\| `eventDescription` | false | 文字列 | マーケティングイベントの説明。 |
\| `eventUrl` | false | 文字列 | 外部イベントアプリケーションでマーケティングイベントが存在するURL。 |
\| `eventCancelled` | false | ブール値 | マーケティングイベントがキャンセルされたかどうかを示します。デフォルトでは`false` | に設定されます。 |
HubSpotは`X-HubSpot-Signature-v3`ヘッダーも送信します。これは、リクエストがHubSpotから送信されたことを確認するために使用できます。署名の詳細とその検証方法については、[リクエスト署名](/apps/legacy-apps/authentication/validating-requests)を参照してください。
### ステップ2：HubSpotにAPIへのURLパスを提供する
特定のマーケティングイベントの詳細を提供するオブジェクトを返すAPIをアプリで作成したので、次は`/marketing/v3/marketing-events/{appId}/settings`に`POST`リクエストを送信して、HubSpotにAPIへのURLパスを提供する必要があります。これにより、HubSpotはアプリにリクエストを送信してマーケティングイベントの詳細を取得する方法を決定できます。
`POST`リクエストの本文で、`eventDetailsURL`フィールドを使用してURLを指定します。`eventDetailsURL`は次の2つの要件を満たす必要があります。
* `%s`文字列を含んでいること。HubSpotはこの文字列をパスパラメーターとして使用し、イベントのID（`externalEventId`）に代入します。
* `https://`プレフィックスとドメイン名（例：`my.event.app`）を含む、APIリソースへのフルパスであること。
例えば、`https://my.event.app/events/%s`の`eventDetailsURL`を設定し、IDが`1234-event-XYZ`のイベントの詳細を取得するリクエストを送信する必要がある場合、HubSpotアプリのIDが`app-101`で、アカウントのIDが`ABC-account-789`だとすると、HubSpotは次のURLに`GET`リクエストを送信します。
`https://my.event.app/events/1234-event-XYZ?appId=app-101&externalAccountId=ABC-account-789`