Recurso: LoyaltyObject
Representação JSON |
---|
{ "kind": string, "classReference": { object ( |
Campos | |
---|---|
kind |
Identifica o tipo de recurso. Valor: a string fixa |
class |
Uma cópia dos campos herdados da classe pai. Esses campos são recuperados durante um GET. |
account |
O nome do titular da conta de fidelidade, como "João Silva". O comprimento máximo recomendado é 20 caracteres, para garantir que a string inteira seja exibida em telas menores. |
account |
O identificador da conta de fidelidade. O tamanho máximo recomendado é 20 caracteres. |
loyalty |
Rótulo, saldo e tipo de pontos de prêmios do programa de fidelidade. |
linked |
Uma lista de objetos de oferta vinculados a este cartão de fidelidade. Os objetos de oferta precisam já existir. Os IDs de objeto da oferta precisam seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o segundo é escolhido por você. |
secondary |
Rótulo, saldo e tipo de pontos de prêmios por fidelidade secundários. Mostrado além dos pontos de fidelidade principais. |
id |
Obrigatório. O identificador exclusivo de um objeto. Esse ID precisa ser exclusivo entre todos os objetos de um emissor. Esse valor precisa seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o segundo é escolhido por você. O identificador exclusivo deve incluir apenas caracteres alfanuméricos, ".", "_" ou "-". |
class |
Obrigatório. A classe associada a este objeto. A classe precisa ser do mesmo tipo que este objeto, já existir e ser aprovada. Os IDs de classe precisam seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o último é escolhido por você. |
version |
Suspenso |
state |
Obrigatório. O estado do objeto. Este campo é usado para determinar como um objeto é exibido no app. Por exemplo, um objeto |
barcode |
O tipo e o valor do código de barras. |
messages[] |
Um conjunto de mensagens exibidas no app. Todos os usuários deste objeto receberão as mensagens associadas. O número máximo destes campos é 10. |
valid |
O período em que esse objeto fica |
locations[] |
Observação: no momento, esse campo não é compatível com o acionamento de notificações geográficas. |
has |
Indica se o objeto tem usuários. Este campo é definido pela plataforma. |
smart |
O valor que será transmitido para um terminal certificado pelo Toque inteligente por NFC para esse objeto. Os campos de nível de classe Se esse valor não for definido, mas os campos |
has |
Indica se este objeto está vinculado a um único dispositivo no momento. Este campo é definido pela plataforma quando um usuário salva o objeto, vinculando-o ao dispositivo. Destinado ao uso por parceiros selecionados. Entre em contato com o suporte para mais informações. |
disable |
Indica se as notificações devem ser explicitamente suprimidas. Se esse campo estiver definido como verdadeiro, independentemente do campo Atualmente, só é possível definir isso para ofertas. |
info |
Obsoleto. Use textModulesData. |
image |
Dados do módulo de imagem. O número máximo de campos exibidos é 1 no nível do objeto e 1 no nível do objeto da classe. |
text |
Dados do módulo de texto. Se os dados do módulo de texto também estiverem definidos na classe, ambos serão exibidos. O número máximo de campos exibidos é 10 para o objeto e 10 para a classe. |
links |
Dados do módulo de links. Se os dados do módulo de links também estiverem definidos na classe, ambos serão exibidos. |
app |
Link opcional do app ou site que vai aparecer como um botão na frente do cartão. Se o AppLinkData for fornecido para a classe correspondente, apenas o objeto AppLinkData será exibido. |
rotating |
O tipo e o valor do código de barras rotativo. |
hero |
Imagem do banner opcional exibida na parte frontal do cartão. Se não houver nenhuma, a imagem principal da classe, se houver, será exibida. Se a imagem principal da classe também não estiver presente, nada será exibido. |
grouping |
Informações que controlam como os cartões são agrupados. |
pass |
Transmitir restrições para o objeto. Inclui limitar os comportamentos de NFC e captura de tela. |
save |
Restrições no objeto que precisam ser verificadas antes que o usuário tente salvar o cartão. Essas restrições só serão aplicadas durante o tempo de gravação. Se as restrições mudarem depois que um usuário salvar o cartão, as novas restrições não serão aplicadas a um cartão já salvo. |
linked |
Os linkedObjectIds são uma lista de outros objetos, como ingresso de evento, fidelidade, oferta, genérico, vale-presente, transporte público e cartão de embarque, que precisam ser anexados automaticamente a esse objeto de fidelidade. Se um usuário tivesse salvo esse cartão de fidelidade, esses linkedObjectIds seriam enviados automaticamente à carteira do usuário (a menos que ele tivesse desativado a configuração para receber esses cartões vinculados). Verifique se os objetos presentes em linkedObjectIds já foram inseridos. Caso contrário, as chamadas vão falhar. Depois de vincular, não é possível desvincular os objetos. Não é possível vincular objetos que pertencem a outro emissor. Há um limite para o número de objetos que podem ser vinculados a um único objeto. Quando o limite for atingido, os novos objetos vinculados na chamada serão ignorados silenciosamente. Os IDs de objeto precisam seguir o formato issuer ID.identifier, em que o primeiro é emitido pelo Google e o segundo é escolhido por você. |
notify |
Se as atualizações de campo para esse objeto precisam acionar notificações. Quando definida como NOTIFY, tentaremos acionar uma notificação de atualização de campo para os usuários. Essas notificações só serão enviadas aos usuários se o campo fizer parte de uma lista de permissões. Se definido como DO_NOT_NOTIFY ou NOTIFICATION_SETTINGS_UNSPECIFIED, nenhuma notificação será acionada. Essa configuração é temporária e precisa ser definida com cada solicitação PATCH ou UPDATE. Caso contrário, uma notificação não será acionada. |
value |
Dados opcionais do módulo de valor agregado. Máximo de dez no objeto. |
LoyaltyPoints
Representação JSON |
---|
{ "label": string, "balance": { object ( |
Campos | |
---|---|
label |
O rótulo de pontos de fidelidade, como "Pontos". O tamanho máximo recomendado é 9 caracteres. |
balance |
O saldo dos pontos de fidelidade do titular da conta, como "500" ou "US$ 10,00". O tamanho máximo recomendado é 7 caracteres. Este é um campo obrigatório de |
localized |
Strings traduzidas do rótulo. O comprimento máximo recomendado é 9 caracteres. |
LoyaltyPointsBalance
Representação JSON |
---|
{
"string": string,
"int": integer,
"double": number,
"money": {
object ( |
Campos | |
---|---|
string |
A forma de string de um saldo. Somente um desses subtipos (string, int, double, money) deve ser preenchido. |
int |
A forma do número inteiro de um saldo. Somente um desses subtipos (string, int, double, money) deve ser preenchido. |
double |
A forma dupla de um saldo. Somente um desses subtipos (string, int, double, money) deve ser preenchido. |
money |
A forma monetária de um saldo. Somente um desses subtipos (string, int, double, money) deve ser preenchido. |
Métodos |
|
---|---|
|
Adiciona uma mensagem ao objeto de fidelidade indicado pelo ID de objeto fornecido. |
|
Retorna o objeto de fidelidade com o ID de objeto fornecido. |
|
Insere um objeto de fidelidade com o código e as propriedades fornecidos. |
|
Retorna uma lista de todos os objetos de fidelidade de um determinado ID de emissor. |
|
Modifica objetos de oferta vinculados do objeto de fidelidade com o ID fornecido. |
|
Atualiza o objeto de fidelidade indicado pelo ID de objeto fornecido. |
|
Atualiza o objeto de fidelidade indicado pelo ID de objeto fornecido. |