Recurso REST: loyaltyclass

Recurso: LoyaltyClass

Representação JSON

{
      "kind": string,
      "programName": string,
      "programLogo": {
        object (Image)
      },
      "accountNameLabel": string,
      "accountIdLabel": string,
      "rewardsTierLabel": string,
      "rewardsTier": string,
      "localizedProgramName": {
        object (LocalizedString)
      },
      "localizedAccountNameLabel": {
        object (LocalizedString)
      },
      "localizedAccountIdLabel": {
        object (LocalizedString)
      },
      "localizedRewardsTierLabel": {
        object (LocalizedString)
      },
      "localizedRewardsTier": {
        object (LocalizedString)
      },
      "secondaryRewardsTierLabel": string,
      "localizedSecondaryRewardsTierLabel": {
        object (LocalizedString)
      },
      "secondaryRewardsTier": string,
      "localizedSecondaryRewardsTier": {
        object (LocalizedString)
      },
      "discoverableProgram": {
        object (DiscoverableProgram)
      },
      "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)
      }
    }
Campos
kind
(deprecated)

string

Identifica o tipo de recurso. Valor: a string fixa "walletobjects#loyaltyClass".

programName

string

Obrigatório. O nome do programa, como "Adam's Apparel". O app pode exibir reticências após os primeiros 20 caracteres para garantir que a string inteira seja exibida em telas menores.

accountNameLabel

string

O rótulo do nome da conta, como "Nome do membro". O tamanho máximo recomendado é 15 caracteres para garantir que a string inteira seja exibida em telas menores.

accountIdLabel

string

O rótulo do ID da conta, como "ID do membro". O tamanho máximo recomendado é 15 caracteres para garantir que a string inteira seja exibida em telas menores.

rewardsTierLabel

string

O rótulo do nível de prêmios, como "Nível de prêmios". O tamanho máximo recomendado é 9 caracteres para garantir que a string inteira seja exibida em telas menores.

rewardsTier

string

O nível de prêmios, como "Ouro" ou "Platinum". O tamanho máximo recomendado é 7 caracteres para garantir que a string inteira seja exibida em telas menores.

localizedProgramName

LocalizedStringobject ()

Strings traduzidas do programName. O app pode exibir reticências após os primeiros 20 caracteres para garantir que a string inteira seja exibida em telas menores.

localizedAccountNameLabel

LocalizedStringobject ()

Strings traduzidas do accountNameLabel. O tamanho máximo recomendado é 15 caracteres para garantir que a string inteira seja exibida em telas menores.

localizedAccountIdLabel

LocalizedStringobject ()

Strings traduzidas do accountIdLabel. O tamanho máximo recomendado é 15 caracteres para garantir que a string inteira seja exibida em telas menores.

localizedRewardsTierLabel

LocalizedStringobject ()

Strings traduzidas do rewardsTierLabel. O tamanho máximo recomendado é 9 caracteres para garantir que a string inteira seja exibida em telas menores.

localizedRewardsTier

LocalizedStringobject ()

Strings traduzidas do rewardsTier. O comprimento máximo recomendado é 7 caracteres. para garantir que a string inteira seja exibida em telas menores.

secondaryRewardsTierLabel

string

O rótulo do nível secundário de prêmios, como "Nível de prêmios".

localizedSecondaryRewardsTierLabel

LocalizedStringobject ()

Strings traduzidas do secondaryRewardsTierLabel.

secondaryRewardsTier

string

O nível secundário de recompensas, como "Ouro" ou "Platinum".

localizedSecondaryRewardsTier

LocalizedStringobject ()

Strings traduzidas do secondaryRewardsTier.

discoverableProgram

DiscoverableProgramobject ()

Informações sobre como a classe pode ser descoberta e instanciada no app Google Pay.

classTemplateInfo

ClassTemplateInfoobject ()

Informações de modelo sobre como a classe deve ser exibida. Se não estiver definido, o Google usará como alternativa um conjunto padrão de campos a serem exibidos.

id

string

Obrigatório. O identificador exclusivo de uma classe. Este código precisa ser exclusivo entre todas as classes de um emissor. Este valor deve seguir o formato código do emissor.identificador, em que o primeiro é emitido pelo Google e o último é escolhido por você. O identificador exclusivo deve incluir apenas caracteres alfanuméricos: ".", "_" ou "-".

version
(deprecated)

string (int64 format)

Obsoleto

issuerName

string

Obrigatório. O nome do emissor. O tamanho máximo recomendado é 20 caracteres para garantir que a string inteira seja exibida em telas menores.

messages[]

Messageobject ()

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.

allowMultipleUsersPerObject
(deprecated)

boolean

Obsoleto. Use multipleDevicesAndHoldersAllowedStatus.

homepageUri

Uriobject ()

O URI da página inicial do seu aplicativo. Preencher o URI neste campo resulta no mesmo comportamento que o preenchimento de um URI em linksModuleData: quando um objeto é renderizado, um link para a página inicial é mostrado no que normalmente seria considerada a seção linksModuleData do objeto.

locations[]

LatLongPointobject ()

A lista de locais em que o objeto pode ser usado. A plataforma usa estas informações para acionar notificações de geolocalização para os usuários. Os locais no objeto modificam os locais na classe, que modificam os locais no ID do Google Places.

reviewStatus

ReviewStatusenum ()

Obrigatório. O status da classe. Este campo pode ser definido como draft ou underReview usando as chamadas de inserção, correção ou atualização de API. Depois que o estado da revisão for alterado de draft, ele não será alterado novamente para draft.

Você precisa manter esse campo como draft quando a classe estiver em desenvolvimento. Não é possível usar uma classe draft para criar nenhum objeto.

Quando acreditar que a classe está pronta para uso, defina este campo como underReview. A plataforma definirá automaticamente esse campo como approved, e ele poderá ser usado na hora para criar ou migrar objetos.

Ao atualizar uma classe já approved, você precisa continuar configurando este campo como underReview.

review

Reviewobject ()

Os comentários de revisão definidos pela plataforma quando uma classe é marcada como approved ou rejected.

infoModuleData
(deprecated)

InfoModuleDataobject ()

Obsoleto. Use textModulesData.

imageModulesData[]

ImageModuleDataobject ()

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.

textModulesData[]

TextModuleDataobject ()

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 no objeto e 10 na classe.

redemptionIssuers[]

string (int64 format)

Disponível apenas para parceiros que aceitam smart tap. Entre em contato com o suporte para mais orientações.

countryCode

string

Código do país usado para exibir o país do cartão (quando o usuário não está neste país), bem como exibir conteúdo localizado quando o conteúdo não está disponível na localidade do usuário.

heroImage

Imageobject ()

Imagem de banner opcional exibida na frente do cartão. Se não houver nenhuma, nada será exibido. A imagem será exibida com 100% de largura.

wordMark
(deprecated)

Imageobject ()

Obsoleto.

enableSmartTap

boolean

Disponível apenas para parceiros que aceitam smart tap. Entre em contato com o suporte para mais orientações.

hexBackgroundColor

string

A cor de fundo do cartão. Se não estiver definida, a cor predominante da imagem principal será usada. Se não houver nenhuma imagem principal definida, a cor predominante do logotipo será usada. O formato é #rrggbb, em que rrggbb é um trio hexadecimal RGB, como #ffcc00. Também é possível usar a versão abreviada do trio RGB, que é #rgb, como #fc0.

localizedIssuerName

LocalizedStringobject ()

Strings traduzidas do issuerName. O tamanho máximo recomendado é 20 caracteres para garantir que a string inteira seja exibida em telas menores.

multipleDevicesAndHoldersAllowedStatus

MultipleDevicesAndHoldersAllowedStatusenum ()

Identifica se vários usuários e dispositivos salvarão o mesmo objeto que faz referência a esta classe.

callbackOptions

CallbackOptionsobject ()

Opções de callback a serem usadas para retornar ao emissor em cada salvamento/exclusão de um objeto desta classe pelo usuário final. Todos os objetos desta classe são qualificados para callback.

DiscoverableProgram

Informações sobre como uma classe pode ser descoberta e instanciada no app Android Pay. Isso é feito pesquisando um programa de fidelidade ou vale-presente e digitalizando-o ou inserindo-o manualmente.

Representação JSON

{
      "merchantSignupInfo": {
        object (DiscoverableProgramMerchantSignupInfo)
      },
      "merchantSigninInfo": {
        object (DiscoverableProgramMerchantSigninInfo)
      },
      "state": enum (State)
    }
Campos
merchantSignupInfo

DiscoverableProgramMerchantSignupInfoobject ()

Informações sobre a capacidade de se inscrever e adicionar algo valioso a este programa por meio de um site comercial. Usado quando MERCHANT_HOSTED_SIGNUP está ativado.

merchantSigninInfo

DiscoverableProgramMerchantSigninInfoobject ()

Informações sobre a capacidade de fazer login e adicionar algo valioso a este programa por meio de um site comercial. Usado quando MERCHANT_HOSTED_SIGNIN está ativado.

state

Stateenum ()

Estado de visibilidade do programa detectável.

DiscoverableProgramMerchantSignupInfo

Informações sobre o fluxo de inscrição hospedado pelo comerciante para um programa.

Representação JSON

{
      "signupWebsite": {
        object (Uri)
      },
      "signupSharedDatas": [
        enum (SharedDataType)
      ]
    }
Campos
signupWebsite

Uriobject ()

O URL para direcionar o usuário ao site de inscrição do comerciante.

signupSharedDatas[]

SharedDataTypeenum ()

Dados do usuário que são enviados em uma solicitação POST ao URL do site de inscrição. Essas informações são codificadas e compartilhadas para que o site do comerciante preencha previamente os campos usados para registrar o usuário no programa detectável.

SharedDataType

Enums
SHARED_DATA_TYPE_UNSPECIFIED
FIRST_NAME
LAST_NAME
STREET_ADDRESS campo de endereço de linha única
ADDRESS_LINE_1 campos de endereço de várias linhas
ADDRESS_LINE_2
ADDRESS_LINE_3
CITY
STATE
ZIPCODE
COUNTRY
EMAIL
PHONE

DiscoverableProgramMerchantSigninInfo

Informações sobre o fluxo de login hospedado pelo comerciante para um programa.

Representação JSON

{
      "signinWebsite": {
        object (Uri)
      }
    }
Campos
signinWebsite

Uriobject ()

O URL para direcionar o usuário ao site de login do comerciante.

Estado

Enums
STATE_UNSPECIFIED
TRUSTED_TESTERS Visível apenas para testers com acesso à conta do emissor.
trustedTesters

Alias legado de TRUSTED_TESTERS. Obsoleto.

LIVE Visível a todos.
live

Alias legado de LIVE. Obsoleto.

DISABLED Não visível.
disabled

Alias legado de DISABLED. Obsoleto.

Métodos

addmessage

Adiciona uma mensagem à classe de fidelidade indicada pelo código de classe fornecido.

get

Retorna a classe de fidelidade com o código de classe fornecido.

insert

Insere uma classe de fidelidade com o código e as propriedades fornecidos.

list

Retorna uma lista de todas as classes de fidelidade de um determinado código de emissor.

patch

Atualiza a classe de fidelidade indicada pelo código de classe fornecido.

update

Atualiza a classe de fidelidade indicada pelo código de classe fornecido.