ゲストの回収(レガシー)

!重要このREST APIの新しいバージョン(v2.1)が利用可能です。このREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っているなら、v2とv2.1の違いについて読 んでアップグレードしましょう。

GET /v2/guests

ゲストのメールアドレスやその他の識別情報を使って検索します。

応答において、items.hrefにおいて、ゲスト参照は最後のスラッシュの後に続く文字列です:

"href": "/v2/guests/"

例えば、ゲスト参照を使ってゲストレコード全体とやり取りし、取得 や 更新 を行います。

ゲスト参照を使ってSitecore CDP内のゲストに関するデータを検索することもできます。Sitecore CDPで「 ゲスト」をクリックします。 Searchフィールドでゲスト参照を入力します。その後、Sitecore CDPはゲストのプロフィールを表示します。

ゲストをメールで呼び寄せる:

curl -X GET '/v2/guests?email=[email protected]' \ -u ':' \ -H 'Accept: application/json'

{ "href": "/v2/guests?offset=0&limit=10&email=[email protected]", "offset": 0, "limit": 10, "items": { "href": "/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03" }

}

識別子によるゲストの取得:

curl -X GET '/v2/guests?identifiers.provider=BXLP&identifiers.id=123456' \ -u ':' \ -H 'Accept: application/json'

{ "href": "/v2/guests?offset=0&limit=10&identifiers.provider=BXLP&identifiers.id=123456", "offset": 0, "limit": 10, "items": { "href": "/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03" }

}