---
title: "ゲストREST API v2(レガシー)"
slug: "guest-rest-api-v2--legacy-"
abstract: "Sitecore CDPゲストREST APIで使用されるオブジェクト属性を記述します。"
---
# ゲストREST API v2(レガシー)

> !重要[このREST APIの新しいバージョン(v2.1)が利用可能です](https://api-docs.sitecore.com/cdp/guest-rest-api)。このREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っているなら、[v2とv2.1の違いについて読](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-rest-api-v2--legacy-/differences-between-v2-and-v2-1-of-the-guest-and-guest-data-extension-rest-apis.html "Differences between v2 and v2.1 of the Guest and Guest data extension REST APIs") んでアップグレードしましょう。

ゲストオブジェクトはSitecore CDPの中核的なエンティティです。顧客や見込み客の個人データは記録・保存され、関連する取引および行動データはゲストプロファイルにリンクされています。

以下はゲスト属性です:

属性

種類

概要

例

firstSeen

ISO 8601 日付/時刻 UTC

ゲストの最初のデート。

"2026-01-01T16:17:16.000Z"

lastSeen

ISO 8601 日付/時刻 UTC

ゲストが最後にあなたのブランドとやり取りした時間。ゲストが現在オンラインでブランドと交流している場合、現在のセッション開始日とタイムスタンプが返されます。

"2026-01-01T16:17:16.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:00Z"

emails

JSON文字列配列

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

"john.doe@gmail.com", "john.junior@hotmail.com"

phoneNumbers

JSON文字列配列

ゲストの電話番号。

"+353161123345", "+353861123311"

language

文字列(2文字のISO 639言語コード)

ゲストの好む言語。

"EN", "FR", "DE"

nationality

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

ゲストの国籍。

"Irish", "British", "Spanish", "French"

passportNumber

文字列(大文字)

ゲストのパスポート番号。

"PZ4A9565"

passportExpiry

ストリング

ゲストのパスポートの有効期限です。

"2025-01-01T00:00: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:16.000Z" }

以下は識別子モデルの属性です:

属性

概要

種類

例

必須/任意

provider

識別子提供者です。

ストリング

"ProfileSystem"

必須

id

識別子のID。

ストリング

"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41"

必須

expiryDate

識別子の有効期限です。

ISO 8601 日付/時刻 UTC

"2025-01-01T16:17:16.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:16.000Z"

modifiedAt

リソースがSitecore CDPで更新された日時。

ISO 8601 日付/時刻 UTC

"2026-01-01T16:17:16.000Z"