ゲストおよびゲストデータ拡張REST APIのv2とv2.1の違い

Sitecore CDPのインスタンスが2.1データモデルを使用している場合は、ゲストおよびゲストデータ拡張のREST APIsバージョン2.1へのアップグレードをお勧めします。

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

v2

v2.1

URI経路

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

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

部分演算の終点

• 部分的な更新や部分的な削除は利用できません。

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

• 新しい PATCH エンドポイントでは 、ゲストの部分的な更新 と データ拡張の一部を更新できます。例えば、特定のキーと値のペアを更新しても他に影響を与えません。

• 新しい DELETE エンドポイントは、 ゲストデータ拡張から特定のキーと値のペアを削除 しても、他の拡張機能には影響を与えません。

• 部分操作では、各ソースシステムごとに異なるデータ拡張名を使う必要はなくなりますが、それでもベストプラクティスとして推奨しています。

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

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

より開発者に優しいデータ拡張エンドポイントでは、データ拡張を作成する際にリクエストボディでデータ拡張名(可能な値を参照)を指定できます。その後、その名前を他のエンドポイントのURIで使用してデータ拡張と連携できます。