REST Resource: loyaltyobject

リソース: LoyaltyObject

JSON 表現
{
  "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)
  }
}
フィールド
kind
(deprecated)

string

リソースのタイプを示します。値: 固定文字列 "walletobjects#loyaltyObject"

classReference

object (LoyaltyClass)

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

accountName

string

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

accountId

string

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

loyaltyPoints

object (LoyaltyPoints)

ポイント プログラムのポイントのラベル、残高、種類。

linkedOfferIds[]

string

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

特典のオブジェクト ID は、issuer ID の形式で指定します。identifier: 前者が Google が発行し、後者がお客様を選択します。

secondaryLoyaltyPoints

object (LoyaltyPoints)

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

id

string

必須。オブジェクトの一意の識別子。この ID は、カード発行会社のすべてのオブジェクトに対して一意である必要があります。この値は、issuer ID の形式に従う必要があります。identifier: 前者が Google が発行し、後者がお客様を選択します。一意の識別子には英数字、「_」、「_」、「-」のみ使用できます。

classId

string

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

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

version
(deprecated)

string (int64 format)

非推奨

state

enum (State)

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

barcode

object (Barcode)

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

messages[]

object (Message)

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

validTimeInterval

object (TimeInterval)

このオブジェクトが active になる期間で、このオブジェクトを使用できます。この期間が過ぎると、オブジェクトの状態は expired に変わります。

locations[]

object (LatLongPoint)

注: 現在このフィールドでは、地域に関する通知のトリガーはサポートされていません。

hasUsers

boolean

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

smartTapRedemptionValue

string

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

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

hasLinkedDevice

boolean

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

disableExpirationNotification

boolean

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

現在、これは商品にのみ設定できます。

infoModuleData

object (InfoModuleData)

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

imageModulesData[]

object (ImageModuleData)

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

textModulesData[]

object (TextModuleData)

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

rotatingBarcode

object (RotatingBarcode)

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

heroImage

object (Image)

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

groupingInfo

object (GroupingInfo)

パスのグループ化方法を制御する情報。

passConstraints

object (PassConstraints)

オブジェクトの制約を渡します。NFC とスクリーンショットの動作を制限します。

ポイント

JSON 表現
{
  "label": string,
  "balance": {
    object (LoyaltyPointsBalance)
  },
  "localizedLabel": {
    object (LocalizedString)
  }
}
フィールド
label

string

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

balance

object (LoyaltyPointsBalance)

アカウント所有者のポイント残高(「500」や「$10.00」など)。最大文字数は 7 文字です。これは loyaltyPointssecondaryLoyaltyPoints の必須フィールドです。

localizedLabel

object (LocalizedString)

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

LoyaltyPointsBalance

JSON 表現
{
  "string": string,
  "int": integer,
  "double": number,
  "money": {
    object (Money)
  }
}
フィールド
string

string

残高の文字列形式です。サブタイプ(string、int、double、money)のいずれか 1 つのみが入力されている必要があります。

int

integer

残高の整数の形式。サブタイプ(string、int、double、money)のいずれか 1 つのみが入力されている必要があります。

double

number

2 倍の残高の残高。サブタイプ(string、int、double、money)のいずれか 1 つのみが入力されている必要があります。

money

object (Money)

残高。サブタイプ(string、int、double、money)のいずれか 1 つのみが入力されている必要があります。

Methods

addmessage

指定されたオブジェクト ID のポイント オブジェクトにメッセージを追加します。

get

指定されたオブジェクト ID のポイント オブジェクトを返します。

insert

指定された ID とプロパティのポイント オブジェクトを挿入します。

list

指定された発行者 ID のすべてのポイント オブジェクトのリストを返します。

modifylinkedofferobjects

指定された ID のポイント オブジェクトのリンクされたクーポン オブジェクトを変更します。

patch

指定されたオブジェクト ID のポイント オブジェクトを更新します。

update

指定されたオブジェクト ID のポイント オブジェクトを更新します。