REST Resource: loyaltyobject

{
  "kind": string,
  "classReference": {
    object (LoyaltyClass)
  },
  "accountName": string,
  "accountId": string,
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "linkedOfferIds": [
    string
  ],
  "secondaryLoyaltyPoints": {
    object (LoyaltyPoints)
  },
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  }
}

string

リソースの種類を指定します。値: 固定文字列 "walletobjects#loyaltyObject"。

object (LoyaltyClass)

親クラスの継承されたフィールドのコピー。これらのフィールドは GET 中に取得されます。

string

ポイント プログラムのアカウント所有者の名前（「山田太郎」）。小さな画面でも文字列全体が表示されるように、20 文字以下にすることをおすすめします。

string

ポイント プログラムのアカウント ID。推奨される最大文字数は 20 文字です。

object (LoyaltyPoints)

ポイント特典ポイントのラベル、残高、種類。

string

このポイントカードにリンクされているクーポン オブジェクトのリスト。オファー オブジェクトは、すでに存在している必要があります。

クーポン オブジェクト ID は issuer ID の形式で指定してください。identifier。前者は Google が発行し、後者は貴社が選択します。

object (LoyaltyPoints)

予備の特典ポイントのラベル、残高、種類。主要なポイントに加えて表示されます。

string

必須。オブジェクトの一意の識別子。この ID は、発行者のすべてのオブジェクトで一意である必要があります。この値は issuer ID の形式にする必要があります。identifier。前者は Google が発行し、後者は貴社が選択します。一意の識別子には、英数字、「.」、「_」、「-」のみを使用してください。

string

必須。このオブジェクトに関連付けられているクラス。クラスはこのオブジェクトと同じ型で、すでに存在し、承認されている必要があります。

クラス ID は issuer ID の形式にする必要があります。identifier。前者は Google が発行し、後者は貴社が選択します。

string (int64 format)

非推奨

enum (State)

必須。オブジェクトの状態。このフィールドは、アプリでのオブジェクトの表示方法を決定するために使用されます。たとえば、inactive オブジェクトは「期限切れのパス」に移動されます。。

object (Barcode)

バーコードのタイプと値。

object (Message)

アプリに表示されるメッセージの配列。このオブジェクトのすべてのユーザーが、関連するメッセージを受け取ります。これらのフィールドの最大数は 10 です。

object (TimeInterval)

このオブジェクトが active になり、オブジェクトが使用可能になる期間。この期間が経過すると、オブジェクトの状態は expired に変更されます。

object (LatLongPoint)

注: 現在、このフィールドで位置情報通知をトリガーすることはサポートされていません。

boolean

オブジェクトにユーザーが含まれているかどうかを示します。このフィールドはプラットフォームによって設定されます。

string

このオブジェクトについて、NFC 経由でスマートタップ認定端末に送信される値。パスでスマートタップをサポートするには、クラスレベルのフィールド enableSmartTap と redemptionIssuers も正しく設定する必要があります。ASCII 文字のみがサポートされています。

この値が設定されていない場合、クラスレベルのフィールド enableSmartTap と redemptionIssuers が正しく設定されていれば、barcode.value フィールドまたは accountId フィールドが存在する場合は、それらがフォールバックとして使用されます。

boolean

このオブジェクトが現在 1 つのデバイスにリンクされているかどうか。このフィールドは、ユーザーがオブジェクトを保存し、デバイスにリンクするときにプラットフォームによって設定されます。一部のパートナーによる使用を想定しています。詳細についてはサポートにお問い合わせください。

boolean

通知を明示的に抑制するかどうかを示します。このフィールドを true に設定した場合、messages フィールドに関係なく、ユーザーへの有効期限通知が抑制されます。デフォルトでは、このフィールドは false に設定されています。

現在、これは特典に対してのみ設定できます。

object (InfoModuleData)

非推奨です。代わりに textModulesData を使用してください。

object (ImageModuleData)

画像モジュール データ。表示されるフィールドの最大数は、オブジェクト レベルでは 1 個、クラス オブジェクト レベルでは 1 個です。

object (TextModuleData)

テキスト モジュールのデータ。テキスト モジュールのデータもクラスに定義されている場合は、両方が表示されます。表示されるフィールドの最大数は、オブジェクトから 10 個、クラスから 10 個です。

object (LinksModuleData)

リンク モジュールのデータ。リンク モジュールのデータもクラスで定義されている場合は、両方が表示されます。

object (AppLinkData)

アプリまたはウェブサイトへのリンク。パスの前面にボタンとして表示されるオプションです。AppLinkData が対応するクラスに提供されている場合は、オブジェクト AppLinkData のみが表示されます。

object (RotatingBarcode)

ローテーション バーコードのタイプと値。

object (Image)

カードの前面に表示されるオプションのバナー画像。何も存在しない場合は、クラスのヒーロー画像が表示されます（存在する場合）。クラスのヒーロー画像も存在しない場合は、何も表示されません。

object (GroupingInfo)

パスのグループ化に関する情報。

object (PassConstraints)

オブジェクトの制約を渡します。NFC の動作の制限やスクリーンショットの動作などが含まれています。

object (SaveRestrictions)

ユーザーがパスの保存を試みる前に確認する必要があるオブジェクトに関する制限。この制限は保存時にのみ適用されます。ユーザーがパスを保存した後に制限が変更された場合、すでに保存されているパスに新しい制限は適用されません。

{
  "label": string,
  "balance": {
    object (LoyaltyPointsBalance)
  },
  "localizedLabel": {
    object (LocalizedString)
  }
}

string

ポイントのラベル（「ポイント」など）。推奨される最大文字数は 9 文字です。

object (LoyaltyPointsBalance)

アカウント所有者のポイント残高（「500」など）（例: 「$10.00」）。推奨される最大文字数は 7 文字です。これは、loyaltyPoints と secondaryLoyaltyPoints の必須フィールドです。

object (LocalizedString)

ラベルの翻訳文字列。推奨される最大文字数は 9 文字です。

{
  "string": string,
  "int": integer,
  "double": number,
  "money": {
    object (Money)
  }
}

string

文字列形式の残高。これらのサブタイプ（string、int、double、money）のいずれか 1 つのみにデータを入力する必要があります。

integer

整数形式の残高。これらのサブタイプ（string、int、double、money）のいずれか 1 つのみにデータを入力する必要があります。

number

二重形の残高。これらのサブタイプ（string、int、double、money）のいずれか 1 つのみにデータを入力する必要があります。

object (Money)

通貨の残高。これらのサブタイプ（string、int、double、money）のいずれか 1 つのみにデータを入力する必要があります。