---
title: "ゲスト削除データモデル"
slug: "guest-delete-data-model"
abstract: "ゲスト削除の標準データモデル(Sitecore CDPバッチAPI)を説明します。"
---
# ゲスト削除データモデル

ゲストの識別方法は組織によって異なります。一部の組織は、providerやidのように、識別にだけidentifiersを使用します。他の組織では、firstName、lastName、emailのようにゲスト属性のみを使用します。これらの組織のうち、識別に必要なゲスト属性の数は任意ですが、マッチング可能なゲストレコードを識別できる十分なゲスト属性が提供されている必要があります。例えば、firstNameやlastNameは削除のためにゲストレコードと一致するのに十分な識別情報を提供していません。

ゲストを削除するには2つのモードがあります。

-   delete モード - ゲストプロファイルおよび関連するセッションやイベントは削除しますが、関連する注文や注文品は削除しません。注文や注文品を削除するには、まずBatch API [order delete](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/using-order-delete.html "Using order delete") エンドポイントを使って注文を削除し、その後 delete モードを使う必要があります。
-   gdpr\_delete モード - ゲストプロファイルおよびセッション、イベント、注文、注文項目を含むすべての関連エンティティを削除します。

ゲストは忘れられる権利があり、GDPR遵守のためにゲストを削除する場合はgdpr\_deleteモードを使用しなければなりません。

バッチファイルを作成する際は、以下の表の属性に加えて [、必要なすべての属性](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-guest/batch-file-formatting-requirements.html#UUID-4499e082-be7d-9ebb-4936-c178936c1e06_para-idm1903351877649584) を含めてください。

属性

概要

種類

例

必須/任意

ref

組織がSitecore CDP外での識別目的で生成する記録の一意IDです。

文字列UUID

"17AC5C03-F7A1-461F-A3B1-C96F43143522"

必須

schema

削除される value フィールドに含まれるレコードの種類。

ストリング

"guest"

必須

mode

レコードを削除する方法や方法を示します。

ストリング

"delete", "gdpr\_delete"

必須

value

識別子やゲスト削除に必要な識別子のコンテナ。

コンテナ

該当なし

必須

identifiers

削除の可能性のためにゲストをマッチングするためのアイデンティティ属性のコンテナです。

コンテナ

該当なし

組織が識別子を使ってアイデンティティを実行する場合、必須です。

email

ゲストのメールアドレス。

文字列(小文字推奨)

"john.doe@gmail.com"

組織が email 属性を使ってアイデンティティを実行する場合に必要です。

firstName

ゲストの名前。

ストリング(タイトルケース)

"John"

組織が firstName 属性を使ってアイデンティティを実行する場合に必要です。

lastName

ゲストの姓。

ストリング(推奨タイトル格)

"Doe"

あなたの組織がゲスト識別に lastName 属性を使用している場合に必須です。

provider

識別子の提供者です。

ストリング

"IDENTITY\_SYSTEM"

組織が識別子を使ってアイデンティティを実行する場合、必須です。

id

識別子の一意IDです。

ストリング

"BX\_201504"

組織がゲスト識別に識別子を使用している場合、必須です。

こちらはidentifiersを使ってゲストを識別するJSON例です:

{
 "ref": "17AC5C03-F7A1-461F-A3B1-C96F43143522",
 "schema": "guest",
 "mode": "delete",
 "value": {
 "identifiers": 
 {
 "provider": "IDENTITY\_SYSTEM",
 "id": "BX\_201504"
 }
 
 }
}

以下は、ゲストを識別するために個人識別識別子(PII)を使ったJSONの例です:

{
 "ref":"17AC5C03-F7A1-461F-A3B1-C96F43143522",
 "schema":"guest",
 "mode":"delete",
 "value":{
 "email":"john.doe@gmail.com",
 "firstName":"John",
 "lastName":"Doe"
 }
}

## 回答例

以下は、一致するゲストが一人見つかった場合の回答です:

{"ref":"<UUID>","code":"200","message":"Guest and associated entities deleted"}

以下は、複数の一致するゲストが見つかった回答です:

{"ref":"<UUID>","code":"200","message":"3 matches found for this guest, 1st match deleted"}

以下は、一致するゲストが見つからなかった場合の回答です:

{"ref":"<UUID>","code":"404","message":"Guest not found"}

以下は、一致するゲストを見つけるのに十分な身元情報が提供されなかった場合の回答です:

{"ref":"<UUID>","code":"400","message":"Not enough identifying information"}

以下は、ゲストが現在オンラインだったため削除できなかった場合の回答です:

{"ref":"<UUID>","code":"403","message":"Unable to delete Guest: Guest has an open session"}