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)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  }
}
フィールド
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)

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

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 の動作の制限やスクリーンショットの動作などが含まれています。

saveRestrictions

object (SaveRestrictions)

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

LoyaltyPoints

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

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

money

object (Money)

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

メソッド

addmessage

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

get

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

insert

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

list

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

modifylinkedofferobjects

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

patch

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

update

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