---
title: "ゲストおよびゲストデータ拡張REST APIのv2とv2.1の違い"
slug: "differences-between-v2-and-v2-1-of-the-guest-and-guest-data-extension-rest-apis"
abstract: "Sitecore CDPゲストおよびゲストデータ拡張REST APIのバージョン2.1で何が変更されたのかを確認し、アップグレードが可能です。"
---
# ゲストおよびゲストデータ拡張REST APIのv2とv2.1の違い

Sitecore CDPのインスタンスが[2.1データモデル](https://doc.sitecore.com/cdp/ja/developers/api/rest-apis/legacy-rest-apis/guest-rest-api-v2--legacy-/index-en.html#UUID-fa0730dc-dcdf-341a-4167-ecbe18758626 "Data models")を使用している場合は、ゲストおよびゲストデータ拡張のREST APIsバージョン2.1へのアップグレードをお勧めします。

バージョン2とバージョン2.1の主な違いの概要は以下の通りです。

v2

v2.1

URI経路

URIパスには /v2/が含まれています。

URIパスには /v2.1/が含まれています。

部分演算の終点

-   部分的な更新や部分的な削除は利用できません。
-   更新や削除はリソース全体に影響します。そのため、各ソースシステムごとに異なるデータ拡張名を使用し、あるソースシステムからの更新が別のソースシステムのデータを上書きしないようにする必要があります。

-   新しい PATCH エンドポイントでは [、ゲストの部分的な更新](https://doc.sitecore.com/cdp/en/developers/guest-rest-api/index.html#tag/Guest/operation/UpdateGuests) と [データ拡張](https://doc.sitecore.com/cdp/en/developers/guest-rest-api/index.html#tag/Guest-data-extension/operation/UpdateGuestDataExtension)の一部を更新できます。例えば、特定のキーと値のペアを更新しても他に影響を与えません。
-   新しい DELETE エンドポイントは、 [ゲストデータ拡張から特定のキーと値のペアを削除](https://doc.sitecore.com/cdp/en/developers/guest-rest-api/index.html#tag/Guest-data-extension/operation/deleteGuestDataExtensionFields) しても、他の拡張機能には影響を与えません。
-   部分操作では、各ソースシステムごとに異なるデータ拡張名を使う必要はなくなりますが、それでもベストプラクティスとして推奨しています。

データ拡張のエンドポイント

データ拡張用のエンドポイントは、開発者にとってあまり優しくないデータ拡張の参照を使用します。

より開発者に優しいデータ拡張エンドポイントでは、データ拡張を作成する際にリクエストボディでデータ拡張名([可能な値を参照](https://doc.sitecore.com/cdp/en/developers/guest-rest-api/index.html#tag/Guest-data-extension/operation/CreateGuestDataExtension))を指定できます。その後、その名前を他のエンドポイントのURIで使用してデータ拡張と連携できます。