ゲストREST API v2(レガシー)
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
!重要このREST APIの新しいバージョン(v2.1)が利用可能です。このREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っているなら、v2とv2.1の違いについて読 んでアップグレードしましょう。
ゲストオブジェクトはSitecore CDPの中核的なエンティティです。顧客や見込み客の個人データは記録・保存され、関連する取引および行動データはゲストプロファイルにリンクされています。
以下はゲスト属性です:
属性
種類
概要
例
firstSeen
ISO 8601 日付/時刻 UTC
ゲストの最初のデート。
"2026-01-01T16:17
.000Z"lastSeen
ISO 8601 日付/時刻 UTC
ゲストが最後にあなたのブランドとやり取りした時間。ゲストが現在オンラインでブランドと交流している場合、現在のセッション開始日とタイムスタンプが返されます。
"2026-01-01T16:17
.000Z"guestType
文字列エナック(小文字)
獲得されたアイデンティティのレベル。
以下のいずれかでなければなりません:
- "visitor"
- "customer"
- "traveller"
title
ストリング(タイトルケース)
ゲストの称号。
"Br", "Brigadier", "Capt", "Colonel", "Dame", "Dr", "Elder", "Fr", "General", "Hon", "Judge", "Lord", "Master", "Miss", "Mr", "Mrs", "Ms", "Mstr", "Prof", "Rabbi", "Rev", "Shaikha", "Sheikh", "Sir", "Sister", "Sr"
firstName
ストリング(タイトルケース)
ゲストの名前。
"John"
lastName
文字列(タイトル小格を推奨)
ゲストの姓。
"Doe"
gender
文字列(小文字)
ゲストの性別。
"male", "female", "unknown"
dateOfBirth
ISO 8601 UTCの日付/時刻検証
。ゲストの生年月日。
"1985-12-24T00
"emails
JSON文字列配列
ゲストのメールアドレス。
"[email protected]", "[email protected]"
phoneNumbers
JSON文字列配列
ゲストの電話番号。
"+353161123345", "+353861123311"
language
文字列(2文字のISO 639言語コード)
ゲストの好む言語。
"EN", "FR", "DE"
nationality
ストリング(タイトルケース)
ゲストの国籍。
"Irish", "British", "Spanish", "French"
passportNumber
文字列(大文字)
ゲストのパスポート番号。
"PZ4A9565"
passportExpiry
ストリング
ゲストのパスポートの有効期限です。
"2025-01-01T00:00
.000Z"street
JSON 文字列配列(タイトルの大文字)
ゲストの住所。
"Ashford House", "Tara Street", "Dublin 2"
city
ストリング(タイトルケース)
ゲストの街。
"Dublin", "London", "Madrid", "Paris"
country
文字列(2文字のISO 3166-1 アルファ2国コード)
ゲストの国だ。
"IE", "GB", "ES", "FR"
postCode
文字列(大文字)
ゲストの郵便番号。
"D2"
state
ストリング(タイトルケース)
ゲストの状態。
"Oregon"
identifiers
JSON JSONオブジェクトの配列
ゲストの識別者リスト。
{ "provider":"SITECORE_IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:17
.000Z" }以下は識別子モデルの属性です:
属性
概要
種類
例
必須/任意
provider
識別子提供者です。
ストリング
"ProfileSystem"
必須
id
識別子のID。
ストリング
"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41"
必須
expiryDate
識別子の有効期限です。
ISO 8601 日付/時刻 UTC
"2025-01-01T16:17
.000Z"オプション
以下は標準的な応答属性です:
属性
概要
種類
例
href
リソース完全限定の位置情報 Uniform Resource Identifier(URI)。
ストリング
"https://{apiEndpoint}/v2/{resourceName}/{resourceRef}"
ref
リソースの参照。
文字列UUID
"9d94ee11-7043-4b71-980c-a777d00a7b46"
createdAt
リソースがSitecore CDPで作成された日時。
ISO 8601 日付/時刻 UTC
"2026-01-01T16:17
.000Z"modifiedAt
リソースがSitecore CDPで更新された日時。
ISO 8601 日付/時刻 UTC
"2026-01-01T16:17
.000Z"