ゲストデータエクステンションの作成 (レガシー)

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

大事な

このREST APIの新しいバージョン(v2.1)が利用可能です。ゲストREST APIを初めて使用する場合は、新しいバージョンを使用してください。または、すでに古いバージョンを使用している場合は、v2とv2.1の違いについて読んでアップグレードできるようにしてください。

POST /v2/guests/{:placeholder-token:}<guestRef>{/:placeholder-token:}/extext

ゲストのゲストデータエクステンションを作成します。

属性	種類	形容	例
{:placeholder-token:}guestRef{/:placeholder-token:}	糸	ゲストレコードの参照。ゲスト参照がわからない場合は、まずゲストを取得します。	f7aabbca-1c1b-4fc2-be72-3e16294a4f03

属性

種類

形容

例

{:placeholder-token:}guestRef{/:placeholder-token:}

糸

ゲストレコードの参照。

ゲスト参照がわからない場合は、まずゲストを取得します。

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

要求本文には、データエクステンションのオブジェクトを1つ含める必要があります。オブジェクトについては、次の点に注意してください。

オブジェクトにはプリミティブ値のみを含めることができます。オブジェクトをネストすることはできません。グループ化が必要な場合は、属性名に共通のプレフィックスを使用します。
ゲストデータエクステンションオブジェクトには、最大100個の属性があります。
オブジェクトには、"key": "default"の必須属性を含める必要があります。
オブジェクトに含めるその他の属性は、ゲストデータエクステンションになります。たとえば、要求本文に "loyaltyTier": "level2" を含めると、Loyalty Tierゲストデータエクステンションになります。

以下は、データエクステンションで属性を使用するためのガイドラインのリストです。

属性名は、JSON RFC 7159仕様に従って、英数字 A-Z、a-z、0-9 である必要があります。
データエクステンションの属性名はキャメルケースで記述する必要があります。
属性名は意味のあるものにすることをお勧めします。
更新により、既存のすべての属性が置き換えられます。したがって、ゲストデータエクステンションを更新するときは、既存の属性と新しい属性をすべて指定する必要があります。

応答では、refキーにデータエクステンション参照が含まれています。データエクステンション参照を使用して、ゲストデータエクステンションを取得、更新、または削除します。

この例では、loyaltyTier、rewardBalance、vipMember、およびloyaltyNumberがゲストデータエクステンションになります。

curl -X POST '<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03/extext' \
-u '<username>:<password>' \
-H 'Accept: application/json' \
--data-raw '
{
    "key": "default",
    "loyaltyTier": "level2",
    "rewardBalance": 5012.25,
    "vipMember": true,
    "loyaltyNumber": 3452
}'

{
    "href": "<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03/extext/09bfc8cc-3815-5b77-b75a-d3cc6a867c1a",
    "ref": "09bfc8cc-3815-5b77-b75a-d3cc6a867c1a",
    "key": "default",
    "createdAt": "2025-12-16T07:39:53.924Z",
    "modifiedAt": "2025-12-16T07:39:53.924Z",
    "vipMember": true,
    "loyaltyTier": "level2",
    "rewardBalance": 5012.25,
    "loyaltyNumber": 3452,
    "guest": {
        "href": "<baseURL>/v2/guests/f7aabbca-1c1b-4fc2-be72-3e16294a4f03"
    }
}

この記事を改善するための提案がある場合は、お知らせください!