Início rápido da API Android para API Google Pay for Passes

A API Android para API Google Pay for Passes permite que os usuários salvem objetos valiosos no Google Pay com o clique de um botão. Neste início rápido de exemplo, apresentamos uma configuração simples para salvar objetos de fidelidade, vale-presente e oferta.

Siga o guia SDK do Android e estas etapas para executar o app Android de exemplo:

Passo 1: configurar o app Android

O início rápido é um projeto de código aberto que é possível salvar pelo GitHub. Para fazer o download deste projeto, siga estes passos:

  1. Visite o repositório do GitHub.
  2. Faça o download do arquivo zip ou execute git clone https://github.com/google-pay/s2gp-quickstart-android para clonar o repositório.

O app de exemplo pode acabar sendo aberto com o Android Studio como um projeto atual. O projeto pode precisar ser sincronizado para ser compilado corretamente. Depois de ser criado no Android Studio, o app de exemplo poderá ser executado em um dispositivo Android ou em um emulador.

Passo 2: criar uma classe

Uma classe pode ser criada a partir da API Google Pay for Passes Merchant. Na página "Classes" do Merchant Center, selecione "Criar classe" para criar a classe. Os campos de entrada com um contorno vermelho são obrigatórios, e os restantes são opcionais. Para qualquer campo com um URL, verifique se o link está acessível publicamente. A classe criada será referenciada durante a criação do objeto valioso.

Passo 3: configurar o app Android

Para configurar o app de exemplo para funcionar corretamente, determinados valores precisam ser ajustados. No strings.xml encontrado no app/res/values/:

  1. Substitua o valor ISSUER_ID pelo código do emissor da API Google Pay for Passes.
  2. Substitua LOYALTY_CLASS_ID, GIFTCARD_CLASS_ID ou OFFER_CLASS_ID pelo nome da classe de interesse já criada na API Google Pay for Passes Merchant Center.

Dentro de MainActivity.java, determinados valores de cada tipo de objeto precisam ser configurados de maneira que correspondam à classe que o objeto referencia no Merchant Center:

  1. Para um GiftCardWalletObject no método generateGiftCardWalletObject, setIssuerName e setTitle precisam corresponder aos valores na classe.
  2. Para um LoyaltyWalletObject no método generateLoyaltyWalletObject, setIssuerName e setProgramName precisam corresponder aos valores na classe.
  3. Para um OfferWalletObject no método generateLoyaltyWalletObject, setIssuerName e setTitle precisam corresponder aos valores na classe.

Passo 4: testar o app Android

O aplicativo Android pode ser executado por meio de um emulador ou de um dispositivo Android físico. Depois que o Gradle for sincronizado corretamente, execute o app por meio do Android Studio e selecione o destino de implantação desejado. Quando a implantação terminar, o app de exemplo será iniciado automaticamente.