ゲストデータ拡張(レガシー)を作成する
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
!重要このREST APIの新しいバージョン(v2.1)が利用可能です。ゲストREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っている場合は、v2とv2.1の違いについて読 んでアップグレードしてみてください。
POST /v2/guests/
ゲスト用のゲストデータ拡張機能を作成します。
属性
種類
概要
例
guestRef
ストリング
ゲストレコードの参照。
ゲストの紹介がわからない場合は、まず ゲストを回収しましょう。
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 '
{
"href": "