---
title: "ゲスト削除の使用"
slug: "using-guest-delete"
abstract: "ゲスト削除(Sitecore CDPバッチAPI)の使用概要。"
---
# ゲスト削除の使用

::::タブ:::tab{title="2.1"}

Sitecore CDPバッチAPIのゲスト削除エンドポイントは、ゲストレコードおよびそのゲストに関連付けられたすべてのエンティティ(注文、セッション、イベントを含む)を削除できます。これは不可逆的な操作です。ゲストレコードを削除した後は、ゲストレコードや関連するエンティティを取得できません。

以下の手順は、ゲストがどのように削除されるかの概要を提供します:

1.  [ゲストレコードを含むバッチファイルをアップロードしてください](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/upload-batch-file.html "Upload batch file")gdpr\_deletedelete
2.  識別情報が十分であれば次のステップに進みます。識別情報が不足している場合、ゲスト削除エンドポイントはゲストレコードに対して400レスポンス Not Enough Identifying Info を返します。
3.  ゲストレコードが見つかれば次のステップに進みます。ゲストレコードが見つからない場合は、ゲスト削除エンドポイントが404応答 Guest not foundを返します。
4.  ゲスト削除エンドポイントは、アイデンティティが一致するすべてのゲストを見つけようとします:
    -   ゲスト削除エンドポイントは、アイデンティティが一致するゲストを1人しか見つけません。ゲスト削除エンドポイントは200のレスポンス Guest and associated entities deletedを返します。ゲストレコードはセッションやイベントとともに永久に削除されます。注文や注文アイテムは、 gdpr\_delete モードを使用している場合にのみ削除され、 delete モードを使った場合は削除されません。詳細については、 [deleteモードで](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-guest/guest-delete-data-model.html "Guest delete data model")注文データの削除方法をご覧ください。
    -   あるいは、ゲスト削除エンドポイントが同一のアイデンティティを持つ複数のゲストを見つけた場合、ゲストデリートエンドポイントは200のレスポンス n matches found for this guest, 1st match deletedを返します。この200レスポンスでは、nはアイデンティティが一致するゲストの数を表します。最初にアイデンティティが一致するゲストのみが削除されます。同じアイデンティティの残りのゲストレコードを削除するには、この手順を再度実行する必要があります。

### 注意

GDPR準拠の確保

GDPR遵守のためにゲストを削除する場合は、上記の手順を各一致するIDごとに実施しなければなりません。データ管理者として、削除されたゲストの個人情報をいかなるシステムもSitecore CDPに送信しないようにする責任があります。

::::::tab{title="2.0"}

Sitecore CDPバッチAPIのゲスト削除エンドポイントは、ゲストレコードおよびそのゲストに関連付けられたすべてのエンティティ(注文、セッション、イベントを含む)を削除できます。これは不可逆的な操作です。ゲストレコードを削除した後は、ゲストレコードや関連するエンティティを取得できません。

以下の用語は、Sitecore CDPがどのようにゲストを削除しているかを理解するのに役立ちます:

-   連絡先 - 注文書の連絡先は注文の所有者です。例えば、消費者のために航空券を購入した人などです。
-   消費者 - 注文の消費者とは、旅行中や商品・サービスを利用していると記載されている人のことです。その人が注文の連絡先である場合もあれば、そうでない場合もあります。

以下の手順は、ゲストがどのように削除されるかの概要を提供します:

1.  [ゲストレコードを含むバッチファイルをアップロードしてください](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/upload-a-batch-file/upload-batch-file.html "Upload batch file")gdpr\_deletedelete
2.  識別情報が十分であれば次のステップに進みます。識別情報が不足している場合、ゲスト削除エンドポイントはゲストレコードに対して400レスポンス Not Enough Identifying Info を返します。
3.  ゲストレコードが見つかれば次のステップに進みます。ゲストレコードが見つからない場合は、ゲスト削除エンドポイントが404応答 Guest not foundを返します。
4.  ゲスト削除エンドポイントは、アイデンティティが一致するすべてのゲストを見つけようとします:
    -   ゲスト削除エンドポイントは、アイデンティティが一致するゲストを1人しか見つけません。ゲスト削除エンドポイントは200のレスポンス Guest and associated entities deletedを返します。ゲストレコードはセッションやイベントとともに永久に削除されます。注文や注文アイテムは、 gdpr\_delete モードを使用している場合にのみ削除され、 delete モードを使った場合は削除されません。詳細については、 [deleteモードで](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-guest/guest-delete-data-model.html "Guest delete data model")注文データの削除方法をご覧ください。
    -   あるいは、ゲスト削除エンドポイントが同一のアイデンティティを持つ複数のゲストを見つけた場合、ゲストデリートエンドポイントは200のレスポンス n matches found for this guest, 1st match deletedを返します。この200レスポンスでは、nはアイデンティティが一致するゲストの数を表します。最初にアイデンティティが一致するゲストのみが削除されます。同じアイデンティティの残りのゲストレコードを削除するには、この手順を再度実行する必要があります。
5.  ゲストが注文の消費者であって、コンタクトでない場合、以下のような事態が起こります。
    -   Sitecore CDP元のゲストレコードを置き換えるために新しいゲストレコードを作成します。新しいゲストレコードにはトラベラーの guestType があります。
    -   gdpr\_deleteモードでゲスト削除を実行した場合、UI内のゲストプロフィールは**GDPR\_Delete**名、姓**GDPR\_Delete**名で、個人識別情報(PII)は含まれていません。
    -   deleteモードでゲスト削除操作を行った場合、新しいゲストプロファイルは名前が**「削除**済み」と「**削除済み**」になり、個人情報は含まれていません。
    -   新しいゲストプロファイルを作成する目的は、Sitecore CDPの参照整合性を維持することです。つまり、gdpr\_deleteモードが使用されている場合、連絡先のゲストプロファイルの注文を見るユーザーは、名前がgdpr\_delete 、姓がgdpr\_delete の消費者がいるが、個人情報(PII)がない注文に存在していることを確認できます。同様に、deleteモードが使用されている場合、連絡先のゲストプロファイルの注文を見るユーザーは、**名前が削除**され、姓が**削除**されたものの個人識別情報(PII)がない消費者が注文に存在していることを確認できます。
    -   他のゲストプロフィールと同様に、削除されたゲストプロフィールを検索できますが、個人情報は含まれていません。

### 注意

GDPR準拠の確保

GDPR遵守のためにゲストを削除する場合は、上記の手順を各一致するIDごとに実施しなければなりません。データ管理者として、削除されたゲストの個人情報をいかなるシステムもSitecore CDPに送信しないようにする責任があります。

:::::::