--- title: "ゲストデータ拡張(レガシー)を更新する" slug: "update-a-guest-data-extension--legacy-" abstract: "Sitecore CDP Guest data extension REST APIを使ってゲストデータ拡張機能を更新する方法を説明しています。" --- # ゲストデータ拡張(レガシー)を更新する > !重要[このREST APIの新しいバージョン(v2.1)が利用可能です](https://doc.sitecore.com/cdp/en/developers/guest-rest-api/index.html)。ゲストREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っている場合は、[v2とv2.1の違いについて読](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-data-extension-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//extext/ ゲストのデータ拡張をゲストの更新。更新は既存のすべての属性を置き換えます。 属性 種類 概要 例 guestRef ストリング ゲストレコードの参照。 ゲストの紹介がわからない場合は、まず [ゲストを回収](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-data-extension-rest-api-v2--legacy-/retrieve-guests--legacy-.html)しましょう。 f7aabbca-1c1b-4fc2-be72-3e16294a4f03 dataExtensionRef ストリング データ拡張の参照。 データ拡張の参照がわからない場合は、まず [ゲストデータ拡張を作成し](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-data-extension-rest-api-v2--legacy-/create-a-guest-data-extension--legacy-.html)てください。 09bfc8cc-3815-5b77-b75a-d3cc6a867c1a リクエストボディでは、データ拡張用のオブジェクトを1つ含める必要があります。オブジェクトについて以下の点にご注意ください。 - オブジェクトはプリミティブ値のみを含めることができます。オブジェクトをネストすることはできません。グループ化が必要な場合は、属性名に共通のプレフィックスを使いましょう。 - ゲストデータ拡張オブジェクトは最大100の属性を持ちます。 - オブジェクトには以下の必須属性を含める必要があります: "key": "default"。 - オブジェクトに含まれる他の属性はゲストデータ拡張となります。例えば、リクエストボディに "loyaltyTier": "level2" を含めると、 *Loyalty Tier* ゲストデータ拡張になります。 以下は、データ拡張で属性を使用する際のガイドラインの一覧です。 - 属性名は [JSON RFC 7159](https://www.rfc-editor.org/rfc/rfc7159) 仕様に従い、英数字\[A-Z,a-z,0-9\]でなければなりません。 - データ拡張の属性名はキャメルケースで書かなければなりません。 - 属性名を意味のあるものにすることをおすすめします。 - 更新は既存のすべての属性を置き換えます。したがって、ゲストデータ拡張を更新する際は、既存のすべての属性と新しい属性の両方を提供しなければなりません。 curl -X POST '/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03/extext/09bfc8cc-3815-5b77-b75a-d3cc6a867c1a' \\ -u ':' \\ -H 'Accept: application/json' \\ --data-raw ' { "key": "default", "membership": "deactivated" }' { "href": "/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03/extext/09bfc8cc-3815-5b77-b75a-d3cc6a867c1a", "ref": "09bfc8cc-3815-5b77-b75a-d3cc6a867c1a", "key": "default", "createdAt": "2026-12-16T07:\`53:19\`.253Z", "modifiedAt": "2026-12-16T07:\`53:41\`.572Z", "membership": "deactivated", "guest": { "href": "/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03" } }