REST Resource: offerclass

资源:OfferClass

JSON 表示法
{
  "kind": string,
  "title": string,
  "redemptionChannel": enum (RedemptionChannel),
  "provider": string,
  "titleImage": {
    object (Image)
  },
  "details": string,
  "finePrint": string,
  "helpUri": {
    object (Uri)
  },
  "localizedTitle": {
    object (LocalizedString)
  },
  "localizedProvider": {
    object (LocalizedString)
  },
  "localizedDetails": {
    object (LocalizedString)
  },
  "localizedFinePrint": {
    object (LocalizedString)
  },
  "shortTitle": string,
  "localizedShortTitle": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideTitleImage": {
    object (Image)
  }
}
字段
kind
(deprecated)

string

标识这是什么资源类型。值:固定字符串 "walletobjects#offerClass"

title

string

必需。优惠的标题,例如“购买任一件 T 恤衫八折优惠”。建议的最大长度为 60 个字符,以确保字符串能在较小的屏幕上完整显示。

redemptionChannel

enum (RedemptionChannel)

必需。适用于此优惠的兑换渠道。

provider

string

必需。优惠提供方(集合商家名称或商家名称)。建议的最大长度为 12 个字符,以确保字符串能在较小的屏幕上完整显示。

titleImage

object (Image)

优惠的标题图片。此图片会显示在应用的详细信息视图和列表视图中。

details

string

优惠详情。

finePrint

string

优惠的细则或条款,例如“在亚当服饰店购买任意一件 T 恤即享八折优惠”。

helpUri

object (Uri)

优惠的帮助链接,例如 http://myownpersonaldomain.com/help

localizedTitle

object (LocalizedString)

已翻译的标题字符串。建议的最大长度为 60 个字符,以确保字符串能在较小的屏幕上完整显示。

localizedProvider

object (LocalizedString)

已翻译的提供方字符串。建议的最大长度为 12 个字符,以确保字符串能在较小的屏幕上完整显示。

localizedDetails

object (LocalizedString)

详细信息的翻译后字符串。

localizedFinePrint

object (LocalizedString)

已翻译的 finePrint 字符串。

shortTitle

string

优惠标题的简短版本(例如“八折优惠”),作为优惠内容的快速参考向用户显示。建议的长度上限为 20 个字符。

localizedShortTitle

object (LocalizedString)

短标题的翻译后字符串。建议的长度上限为 20 个字符。

classTemplateInfo

object (ClassTemplateInfo)

有关应如何显示类的模板信息。如果此政策未设置,Google 将回退为显示一组默认字段。

id

string

必需。类的唯一标识符。此 ID 在一个发卡机构的所有类中必须是唯一的。此值应遵循 issuer ID 格式。identifier,其中前者由 Google 提供,后者由您自行选择。您的唯一标识符应仅包含字母数字字符、“.”“_”或“-”。

version
(deprecated)

string (int64 format)

已弃用

issuerName

string

必需。发卡机构名称。建议的最大长度为 20 个字符,以确保字符串能在较小的屏幕上完整显示。

messages[]

object (Message)

应用中显示的一组消息。此对象的所有用户都将收到其相关消息。这些字段的数量上限为 10。

allowMultipleUsersPerObject
(deprecated)

boolean

已弃用。请改用 multipleDevicesAndHoldersAllowedStatus

homepageUri

object (Uri)

应用首页的 URI。在此字段中填充 URI 产生的行为与在 linksModuleData 中填充 URI 完全相同(在呈现对象时,显示指向首页的链接通常会被认为是该对象的 linksModuleData 部分)。

locations[]

object (LatLongPoint)

注意:目前不支持使用此字段触发地理位置通知。

reviewStatus

enum (ReviewStatus)

必需。类的状态。此字段可设置为 draft 或类的状态。可以使用 insert、patch 或 update API 调用将此字段设置为 draftunderReview。审核状态从 draft 更改为其他状态后,便无法再改回 draft

如果该类尚在开发中,您应将此字段保留为 draftdraft 类不能用于创建任何对象。

如果您认为该类可供使用,则应将此字段设置为 underReview。平台会自动将此字段设置为 approved,它可以立即用于创建或迁移对象。

更新 approved 类时,您应将此字段始终设置为 underReview

review

object (Review)

当某个类被标记为 approvedrejected 时,由平台设置的评价注释。

infoModuleData
(deprecated)

object (InfoModuleData)

已弃用。请改用 textModulesData。

imageModulesData[]

object (ImageModuleData)

图片模块数据。对于对象级别,显示的这些字段的最大数量为 1 个;对于类对象级别,显示的数量上限为 1。

textModulesData[]

object (TextModuleData)

文本模块数据。如果还在类中定义了文本模块数据,则将一并显示这些数据。对于对象,显示的这些字段数量上限为 10 个,类中的字段数量上限为 10。

redemptionIssuers[]

string (int64 format)

指明哪些兑换发卡机构可以通过智能触碰兑换卡券。兑换发卡机构由其发卡机构 ID 进行标识。兑换发卡机构必须至少配置一个智能触碰密钥。

此外,还必须正确设置 enableSmartTap 和对象级 smartTapRedemptionLevel 字段,才能让卡券支持智能触碰。

countryCode

string

国家/地区代码,用于显示银行卡所在的国家/地区(当用户不在该国家/地区时),以及在用户的语言区域没有内容时显示本地化内容。

heroImage

object (Image)

在卡片正面显示的可选横幅图片。如果不存在,则不会显示任何内容。图片将以 100% 宽度显示。

wordMark
(deprecated)

object (Image)

已弃用。

enableSmartTap

boolean

标识此类是否支持智能触碰。此外,还必须正确设置 redemptionIssuers 和对象级 smartTapRedemptionLevel 字段,才能让卡券支持智能触碰。

hexBackgroundColor

string

卡片的背景颜色。如果未设置,则系统会使用主打图片的正文色;如果未设置主打图片,则使用徽标的正文色。格式为 #rrggbb,其中 rrggbb 是十六进制 RGB 三元组,例如 #ffcc00。您也可以使用 RGB 三元组的简写版本(即 #rgb),例如 #fc0

localizedIssuerName

object (LocalizedString)

已翻译的 publisherName 字符串。建议的最大长度为 20 个字符,以确保字符串能在较小的屏幕上完整显示。

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

指明是否允许多个用户和设备保存引用此类的同一对象。

callbackOptions

object (CallbackOptions)

回调选项,用于在最终用户每次保存/删除此类的对象时回调发卡机构。此类的所有对象都可以进行回调。

securityAnimation

object (SecurityAnimation)

有关安全动画的可选信息。如果已设置,系统会在卡券详情中呈现安全动画。

viewUnlockRequirement

enum (ViewUnlockRequirement)

查看优惠的解锁要求选项。

wideTitleImage

object (Image)

优惠的宽幅标题图片。如果提供此元素,它将取代卡片视图左上角的标题图片。

RedemptionChannel

枚举
REDEMPTION_CHANNEL_UNSPECIFIED
INSTORE
instore

INSTORE 的旧别名,已弃用。

ONLINE
online

ONLINE 的旧别名,已弃用。

BOTH
both

BOTH 的旧别名,已弃用。

TEMPORARY_PRICE_REDUCTION
temporaryPriceReduction

TEMPORARY_PRICE_REDUCTION 的旧别名,已弃用。

方法

addmessage

向指定类 ID 引用的优惠类添加消息。

get

返回具有指定类 ID 的优惠类。

insert

插入具有指定 ID 和属性的优惠类。

list

返回指定发卡机构 ID 的所有优惠类的列表。

patch

更新指定类 ID 引用的优惠类。

update

更新指定类 ID 引用的优惠类。