---
title: "ゲストの更新(レガシー)"
slug: "update-a-guest--legacy-"
abstract: "Sitecore CDPゲストREST APIを使ってゲストを更新してください。"
---
# ゲストの更新(レガシー)

> !重要[この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") んでアップグレードしましょう。

POST /v2/guests/<guestRef>

ゲストに状況を報告します。

属性

種類

概要

例

guestRef

ストリング

ゲストレコードの参照。  
  
ゲストの紹介がわからない場合は、まず [ゲストを回収](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-rest-api-v2--legacy-/retrieve-guests--legacy-.html)しましょう。

f7aabbca-1c1b-4fc2-be72-3e16294a4f03

個人識別情報(PII)を使ってゲストを更新:

curl -X POST '<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03' \\
-u '<username>:<password>' \\
-H 'Accept: application/json' \\
--data-raw '
{
 "guestType": "customer",
 "title": "Ms",
 "firstName": "Jane",
 "lastName": "Doe",
 "gender": "female",
 "dateOfBirth": "1976-10-28T00:\`00:00\`.000Z",
 "emails": 
 "jane.doe@myretailsite.com"
 ,
 "phoneNumbers": 
 "0851234567"
 ,
 "nationality": "Irish",
 "passportNumber": "PZ4A9565",
 "passportExpiry": "2033-01-01T00:00Z",
 "street": 
 "Apartment 15",
 "West Drive Avenue"
 ,
 "city": "Dublin",
 "country": "IE",
 "postCode": "D2",
 "state": "Dublin",
}'

identifiersを使ってゲストに更新:

curl -X POST '<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03' \\
-u '<username>:<password>' \\
-H 'Accept: application/json' \\
--data-raw '
{
 "guestType":"customer",
 "identifiers":
 {
 "provider":"BXLP",
 "id":"123456",
 "expiryDate":"2028-08-23T16:\`17:16\`.000Z"
 }
 
}'

201 Created個人識別情報(PII)に関する回答:

{
 "href":"<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "ref":"f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "createdAt":"2026-03-07T16:\`15:11\`.000Z",
 "modifiedAt":"2026-08-23T16:\`17:16\`.000Z",
 "firstSeen":"2026-03-07T16:\`15:11\`.000Z",
 "lastSeen":"2026-08-23T16:\`17:16\`.000Z",
 "guestType": "customer",
 "title": "Ms",
 "firstName": "Jane",
 "lastName": "Doe",
 "gender": "female",
 "dateOfBirth": "1976-10-28T00:\`00:00\`.000Z",
 "emails": 
 "jane.doe@myretailsite.com"
 ,
 "phoneNumbers": 
 "0851234567"
 ,
 "nationality": "Irish",
 "passportNumber": "PZ4A9565",
 "street": 
 "Apartment 15",
 "West Drive Avenue"
 ,
 "city": "Dublin",
 "country": "Ireland",
 "postCode": "D2",
 "state": "Dublin",
}

201 Createdidentifiersの回答:

{
 "href":"<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "ref":"f7aabbca-1c1b-4fc2-be72-3e16294a4f03",
 "createdAt":"2026-03-07T16:\`15:11\`.000Z",
 "modifiedAt":"2026-08-23T16:\`17:16\`.000Z",
 "firstSeen":"2026-03-07T16:\`15:11\`.000Z",
 "lastSeen":"2026-08-23T16:\`17:16\`.000Z",
 "guestType":"customer",
 "identifiers":
 {
 "provider":"BXLP",
 "id":"123456",
 "expiryDate":"2028-08-23T16:\`17:16\`.000Z"
 }
 
}